@buoy-design/cli 0.1.19 → 0.1.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +56 -0
  2. package/package.json +3 -3
package/README.md ADDED
@@ -0,0 +1,56 @@
1
+ # @buoy-design/cli
2
+
3
+ Catch design drift before it ships. Buoy scans your codebase to find where AI-generated code diverges from your design system.
4
+
5
+ ## Quick Start
6
+
7
+ ```bash
8
+ npx @buoy-design/cli begin
9
+ ```
10
+
11
+ This scans your project and walks you through setup.
12
+
13
+ ## What It Finds
14
+
15
+ - **Hardcoded colors** like `#3b82f6` instead of design tokens
16
+ - **Magic numbers** like `padding: 17px` instead of spacing variables
17
+ - **AI-generated code** that ignores your team's patterns
18
+
19
+ ## Commands
20
+
21
+ | Command | Purpose |
22
+ |---------|---------|
23
+ | `buoy begin` | Interactive setup wizard |
24
+ | `buoy status` | Quick health overview |
25
+ | `buoy scan` | Scan for components |
26
+ | `buoy drift check` | Detailed drift report |
27
+ | `buoy check` | Pre-commit validation |
28
+
29
+ ## AI Integration
30
+
31
+ Buoy works great with AI coding tools:
32
+
33
+ ```bash
34
+ # Generate a skill file for Claude/Cursor
35
+ buoy skill export
36
+
37
+ # Add design system context to CLAUDE.md
38
+ buoy context
39
+ ```
40
+
41
+ ## CI/CD
42
+
43
+ Block PRs that introduce drift:
44
+
45
+ ```bash
46
+ buoy ci --init
47
+ ```
48
+
49
+ ## Zero Config
50
+
51
+ Buoy auto-detects your framework (React, Vue, Svelte, Angular, Astro) and scans standard paths. No configuration required to get started.
52
+
53
+ ## Links
54
+
55
+ - [Documentation](https://buoy.design/docs)
56
+ - [GitHub](https://github.com/buoy-design/buoy)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@buoy-design/cli",
3
- "version": "0.1.19",
3
+ "version": "0.1.20",
4
4
  "description": "Buoy CLI - Design drift detection for the AI era",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -44,9 +44,9 @@
44
44
  "yaml": "^2.7.0",
45
45
  "zod": "^3.24.1",
46
46
  "zod-validation-error": "^5.0.0",
47
- "@buoy-design/scanners": "0.1.5",
48
47
  "@buoy-design/core": "0.1.4",
49
- "@buoy-design/db": "0.1.2"
48
+ "@buoy-design/db": "0.1.2",
49
+ "@buoy-design/scanners": "0.1.5"
50
50
  },
51
51
  "devDependencies": {
52
52
  "@types/node": "^22.10.2",