Skip to content

Commit 7c4290c

Browse files
authored
Merge pull request #4 from Jpisnice/refine
Refine
2 parents 2db1480 + 2a77822 commit 7c4290c

File tree

13 files changed

+1339
-317
lines changed

13 files changed

+1339
-317
lines changed

.npmignore

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# Source files (we only want the built JS files)
2+
src/
3+
tsconfig.json
4+
5+
# Development files
6+
.env*
7+
*.log
8+
npm-debug.log*
9+
yarn-debug.log*
10+
yarn-error.log*
11+
test-package.sh
12+
examples.sh
13+
14+
# OS generated files
15+
.DS_Store
16+
.DS_Store?
17+
._*
18+
.Spotlight-V100
19+
.Trashes
20+
ehthumbs.db
21+
Thumbs.db
22+
23+
# IDE files
24+
.vscode/
25+
.idea/
26+
*.swp
27+
*.swo
28+
*~
29+
30+
# Node modules (handled by package.json)
31+
node_modules/
32+
33+
# Test files
34+
test/
35+
tests/
36+
*.test.js
37+
*.test.ts
38+
*.spec.js
39+
*.spec.ts
40+
41+
# Documentation that's not needed in package
42+
docs/
43+
CONTRIBUTING.md
44+
V4_MIGRATION_SUMMARY.md
45+
46+
# Git files
47+
.git/
48+
.gitignore

Dockerfile

Lines changed: 0 additions & 23 deletions
This file was deleted.

Dockerfile.http

Lines changed: 0 additions & 23 deletions
This file was deleted.

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2025 Shadcn UI MCP Server
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

PUBLISHING.md

Lines changed: 114 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,114 @@
1+
# Publishing Checklist for shadcn-ui-mcp-server
2+
3+
## ✅ Pre-Publishing Checklist
4+
5+
- [x] Package name is unique and descriptive (`shadcn-ui-mcp-server`)
6+
- [x] Version is set correctly (1.0.0)
7+
- [x] License is included (MIT)
8+
- [x] README.md is comprehensive and up-to-date
9+
- [x] Binary (`shadcn-mcp`) is correctly configured in package.json
10+
- [x] Main entry point is set correctly
11+
- [x] Files array or .npmignore excludes unnecessary files
12+
- [x] Keywords are relevant for discoverability
13+
- [x] Repository URL is set (update with actual URL)
14+
- [x] Author information is set (update with actual info)
15+
- [x] Dependencies are correctly specified
16+
- [x] Build script works (`npm run build`)
17+
- [x] CLI help works (`./build/index.js --help`)
18+
- [x] CLI version works (`./build/index.js --version`)
19+
- [x] Test script passes (`npm test`)
20+
21+
## 📝 Before Publishing
22+
23+
1. **Update package.json with your info:**
24+
```bash
25+
# Update these fields:
26+
- author: "Your Name <[email protected]>"
27+
- repository.url: "git+https://github.com/yourusername/shadcn-ui-mcp-server.git"
28+
- bugs.url: "https://github.com/yourusername/shadcn-ui-mcp-server/issues"
29+
- homepage: "https://github.com/yourusername/shadcn-ui-mcp-server#readme"
30+
```
31+
32+
2. **Check package name availability:**
33+
```bash
34+
npm view shadcn-ui-mcp-server
35+
# Should return "npm ERR! 404 Not Found" if available
36+
```
37+
38+
3. **Final build and test:**
39+
```bash
40+
npm run clean
41+
npm run build
42+
npm test
43+
```
44+
45+
## 🚀 Publishing Steps
46+
47+
1. **Login to npm:**
48+
```bash
49+
npm login
50+
```
51+
52+
2. **Publish the package:**
53+
```bash
54+
npm publish
55+
```
56+
57+
3. **Test the published package:**
58+
```bash
59+
npx shadcn-ui-mcp-server --help
60+
```
61+
62+
## 🔄 Post-Publishing
63+
64+
1. **Update version for next release:**
65+
```bash
66+
npm version patch # for bug fixes
67+
npm version minor # for new features
68+
npm version major # for breaking changes
69+
```
70+
71+
2. **Create GitHub release (if using GitHub):**
72+
- Tag the release
73+
- Add release notes
74+
- Mention the npm package
75+
76+
## 📊 Usage Examples
77+
78+
After publishing, users can:
79+
80+
```bash
81+
# Install globally
82+
npm install -g shadcn-ui-mcp-server
83+
84+
# Or use with npx (recommended)
85+
npx shadcn-ui-mcp-server --help
86+
npx shadcn-ui-mcp-server --github-api-key YOUR_TOKEN
87+
```
88+
89+
## 🎯 Integration Examples
90+
91+
**Claude Desktop:**
92+
```json
93+
{
94+
"mcpServers": {
95+
"shadcn-ui": {
96+
"command": "npx",
97+
"args": ["shadcn-ui-mcp-server", "--github-api-key", "YOUR_TOKEN"]
98+
}
99+
}
100+
}
101+
```
102+
103+
**Continue.dev:**
104+
```json
105+
{
106+
"tools": [{
107+
"name": "shadcn-ui",
108+
"type": "mcp",
109+
"command": "npx",
110+
"args": ["shadcn-ui-mcp-server"],
111+
"env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_TOKEN"}
112+
}]
113+
}
114+
```

0 commit comments

Comments
 (0)