better-icons 1.0.0 → 1.0.1
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.
- package/README.md +30 -33
- package/dist/index.js +195 -0
- package/package.json +11 -8
- package/better-icons/best-practices/SKILLS.md +0 -149
- package/dist/cli.js +0 -302
package/README.md
CHANGED
|
@@ -13,47 +13,30 @@ This MCP server solves that by giving AI models direct access to search and retr
|
|
|
13
13
|
|
|
14
14
|
## Quick Setup
|
|
15
15
|
|
|
16
|
-
### 1. Install the MCP Server
|
|
17
|
-
|
|
18
16
|
```bash
|
|
19
17
|
npx better-icons setup
|
|
20
18
|
```
|
|
21
19
|
|
|
22
20
|
This will interactively configure the MCP server for:
|
|
23
21
|
- **Cursor**
|
|
24
|
-
- **Claude
|
|
25
|
-
- **
|
|
22
|
+
- **Claude Code**
|
|
23
|
+
- **OpenCode**
|
|
26
24
|
- **Windsurf**
|
|
25
|
+
- **VS Code (Copilot)**
|
|
27
26
|
|
|
28
|
-
|
|
27
|
+
## Add AI Skills (Optional)
|
|
29
28
|
|
|
30
|
-
Teach your AI assistant
|
|
29
|
+
Teach your AI assistant best practices for using better-icons:
|
|
31
30
|
|
|
32
31
|
```bash
|
|
33
32
|
npx skills add better-auth/better-icons
|
|
34
33
|
```
|
|
35
34
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
```bash
|
|
39
|
-
npx better-icons rules
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
This opens an interactive selector for:
|
|
43
|
-
- **Cursor**
|
|
44
|
-
- **Claude Code**
|
|
45
|
-
- **Windsurf**
|
|
46
|
-
- **OpenCode**
|
|
47
|
-
- **GitHub Copilot**
|
|
48
|
-
- **Cline / Roo**
|
|
49
|
-
- **Aider**
|
|
50
|
-
|
|
51
|
-
The rules ensure AI assistants will:
|
|
35
|
+
This ensures AI assistants will:
|
|
52
36
|
- ✅ Use the `better-icons` MCP instead of installing icon packages
|
|
53
|
-
- ✅
|
|
37
|
+
- ✅ For React, create a single `icons.tsx` file with all icons
|
|
54
38
|
- ✅ Reuse existing icons before adding new ones
|
|
55
39
|
- ✅ Follow consistent naming conventions
|
|
56
|
-
- ❌ Never install `lucide-react`, `react-icons`, `@heroicons/react`, etc.
|
|
57
40
|
|
|
58
41
|
## Manual Installation
|
|
59
42
|
|
|
@@ -72,9 +55,9 @@ Add to `~/.cursor/mcp.json`:
|
|
|
72
55
|
}
|
|
73
56
|
```
|
|
74
57
|
|
|
75
|
-
### Claude
|
|
58
|
+
### Claude Code (CLI)
|
|
76
59
|
|
|
77
|
-
Add to
|
|
60
|
+
Add to `~/.claude/settings.json`:
|
|
78
61
|
|
|
79
62
|
```json
|
|
80
63
|
{
|
|
@@ -166,13 +149,27 @@ Recommend icons for user authentication
|
|
|
166
149
|
## CLI Commands
|
|
167
150
|
|
|
168
151
|
```bash
|
|
169
|
-
npx better-icons
|
|
170
|
-
npx better-icons setup
|
|
171
|
-
npx better-icons
|
|
172
|
-
npx better-icons
|
|
173
|
-
npx better-icons
|
|
152
|
+
npx better-icons # Run the MCP server (for tool configs)
|
|
153
|
+
npx better-icons setup # Interactive setup wizard
|
|
154
|
+
npx better-icons setup -y # Setup with auto-confirm (global)
|
|
155
|
+
npx better-icons setup -s project # Setup for current project only
|
|
156
|
+
npx better-icons config # Show manual config instructions
|
|
157
|
+
npx better-icons --help # Show help
|
|
174
158
|
```
|
|
175
159
|
|
|
160
|
+
### Options
|
|
161
|
+
|
|
162
|
+
| Option | Description |
|
|
163
|
+
|--------|-------------|
|
|
164
|
+
| `-y, --yes` | Skip confirmation prompts |
|
|
165
|
+
| `-a, --agent <agents...>` | Specify agents (cursor, claude-code, opencode, windsurf, vscode) |
|
|
166
|
+
| `-s, --scope <scope>` | Config scope: `global` (default) or `project` |
|
|
167
|
+
|
|
168
|
+
### Scope
|
|
169
|
+
|
|
170
|
+
- **Global**: Configures MCP server for all projects (stored in home directory)
|
|
171
|
+
- **Project**: Configures MCP server for current project only (stored in project root)
|
|
172
|
+
|
|
176
173
|
## Development
|
|
177
174
|
|
|
178
175
|
```bash
|
|
@@ -180,9 +177,9 @@ npx better-icons help # Show help
|
|
|
180
177
|
bun install
|
|
181
178
|
|
|
182
179
|
# Run locally
|
|
183
|
-
bun run
|
|
180
|
+
bun run dev
|
|
184
181
|
|
|
185
|
-
# Build
|
|
182
|
+
# Build
|
|
186
183
|
bun run build
|
|
187
184
|
```
|
|
188
185
|
|