buoy status

Display a visual coverage grid showing what Buoy has detected in your codebase. Great for getting a quick overview of your design system usage.

Usage

buoy status [options]

Options

Option Description
--json Output as JSON for scripting

Example Output

$ buoy status

Design System Coverage
──────────────────────

Components
  ████████████████████░░░░  85% (42/49 using design system)

Token Categories
  Colors      ████████████░░░░░░░░  60% compliant
  Spacing     ██████████████░░░░░░  70% compliant
  Typography  ████████████████████  100% compliant
  Radius      ████████████████░░░░  80% compliant

Top Issues
  • 23 hardcoded color values
  • 14 non-standard spacing values
  • 3 deprecated patterns

Run `buoy audit` for detailed health report.

Understanding Coverage

Coverage is calculated based on:

  • Components — Percentage using design tokens vs hardcoded values
  • Token compliance — Values that match your design system vs custom values

JSON Output

buoy status --json
{
  "components": {
    "total": 49,
    "compliant": 42,
    "percentage": 85
  },
  "categories": {
    "color": { "compliant": 60, "issues": 23 },
    "spacing": { "compliant": 70, "issues": 14 },
    "typography": { "compliant": 100, "issues": 0 },
    "radius": { "compliant": 80, "issues": 3 }
  }
}

Related Commands