|
| 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