Buoy Design

Design system linting and drift detection for modern frontend teams.

Buoy helps teams maintain design consistency by detecting when code drifts from your design system.

What We Build

Project	Description
buoy	Core scanners, CLI, and MCP server for design system analysis
buoy-action	GitHub Action for CI/CD drift detection
buoy.design	Cloud platform with PR comments, @buoy mentions, and design graphs

Quick Start

GitHub Action (Free)

- uses: ahoybuoy/buoy@v1
  with:
    github-token: ${{ secrets.GITHUB_TOKEN }}

CLI

npx @ahoybuoy/cli check

@buoy Mentions

Install the Buoy GitHub App and mention @buoy-design in any PR comment:

@buoy-design why is this color hardcoded?

Buoy will analyze your code and respond with design system context.

What Buoy Catches

• Hardcoded colors instead of design tokens
• Magic spacing values (padding, margin, gap)
• Arbitrary Tailwind values (bg-[#123456])
• Typography inconsistencies
• Missing component usage

Links

• Documentation
• GitHub Marketplace
• Discord Community

---

Built with care by the Buoy team.