@nimbuslab/cli 1.1.0 → 1.2.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 +167 -75
- package/dist/index.js +745 -1301
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,136 +1,228 @@
|
|
|
1
1
|
# @nimbuslab/cli
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> Modern Next.js project generator with AI-friendly documentation and best practices built-in.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Create production-ready Next.js projects in seconds with intelligent setup, optimized documentation for AI coding assistants, and interactive service configuration.
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
npm install -g @nimbuslab/cli
|
|
9
|
-
```
|
|
7
|
+
## Features
|
|
10
8
|
|
|
11
|
-
|
|
9
|
+
✨ **Modern Stack** - Next.js 16, React 19, TypeScript, Tailwind CSS 4, shadcn/ui
|
|
10
|
+
🤖 **AI-Friendly Documentation** - Auto-generated context files for Claude Code, Cursor, GitHub Copilot
|
|
11
|
+
⚡ **Interactive Setup** - Configure services (email, analytics) during project creation
|
|
12
|
+
📦 **Zero Config** - Smart defaults, production-ready from day one
|
|
13
|
+
🎨 **Beautiful UI** - shadcn/ui components with dark mode support
|
|
14
|
+
|
|
15
|
+
## Quick Start
|
|
12
16
|
|
|
13
17
|
```bash
|
|
14
|
-
|
|
15
|
-
nimbus
|
|
16
|
-
nimbus upgrade # Planejar upgrades de dependencias
|
|
17
|
-
nimbus update # Atualizar o CLI
|
|
18
|
-
nimbus setup node # Configurar ambiente Node.js (Volta)
|
|
19
|
-
nimbus help # Ajuda
|
|
18
|
+
npm install -g @nimbuslab/cli
|
|
19
|
+
nimbus create my-project
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
## Templates
|
|
23
23
|
|
|
24
24
|
### Landing Page
|
|
25
25
|
|
|
26
|
+
Perfect for marketing sites, product launches, and portfolios.
|
|
27
|
+
|
|
26
28
|
```bash
|
|
27
|
-
nimbus create
|
|
29
|
+
nimbus create my-site --landing
|
|
28
30
|
```
|
|
29
31
|
|
|
30
|
-
|
|
32
|
+
**Includes:**
|
|
33
|
+
- Next.js 16 (App Router, Turbopack)
|
|
34
|
+
- React 19 (Server Components)
|
|
35
|
+
- Tailwind CSS 4 (CSS-first)
|
|
36
|
+
- shadcn/ui (default style)
|
|
37
|
+
- TypeScript (strict mode)
|
|
38
|
+
- Responsive design
|
|
39
|
+
- Dark mode support
|
|
40
|
+
- SEO optimized
|
|
41
|
+
|
|
42
|
+
### Web Application
|
|
31
43
|
|
|
32
|
-
|
|
44
|
+
Full-stack app with authentication and database.
|
|
33
45
|
|
|
34
46
|
```bash
|
|
35
|
-
nimbus create
|
|
47
|
+
nimbus create my-app --app
|
|
36
48
|
```
|
|
37
49
|
|
|
38
|
-
|
|
50
|
+
**Everything in Landing, plus:**
|
|
51
|
+
- Better Auth (authentication)
|
|
52
|
+
- Drizzle ORM (database)
|
|
53
|
+
- Protected routes
|
|
54
|
+
- User management
|
|
55
|
+
- Dashboard layout
|
|
56
|
+
- Docker support
|
|
39
57
|
|
|
40
58
|
### Monorepo
|
|
41
59
|
|
|
60
|
+
Turborepo setup for multi-app projects.
|
|
61
|
+
|
|
42
62
|
```bash
|
|
43
|
-
nimbus create
|
|
63
|
+
nimbus create my-workspace --turborepo
|
|
44
64
|
```
|
|
45
65
|
|
|
46
|
-
|
|
66
|
+
**Includes:**
|
|
67
|
+
- Turborepo (build system)
|
|
68
|
+
- Shared packages (ui, config, utils)
|
|
69
|
+
- Multiple apps support
|
|
70
|
+
- Optimized caching
|
|
71
|
+
- Parallel execution
|
|
72
|
+
|
|
73
|
+
## AI-Friendly Documentation
|
|
74
|
+
|
|
75
|
+
Every project includes automatically generated documentation optimized for LLMs:
|
|
47
76
|
|
|
48
|
-
|
|
77
|
+
### Generated Files
|
|
49
78
|
|
|
50
|
-
|
|
79
|
+
- **AGENTS.md** - Universal context for Claude Code, Cursor, GitHub Copilot
|
|
80
|
+
- **llms.txt** - 2026 standard for LLM indexing (ChatGPT, Perplexity)
|
|
81
|
+
- **ARCHITECTURE.md** - Architectural decisions with rationale
|
|
82
|
+
- **EXAMPLES.md** - Common tasks with complete code examples
|
|
83
|
+
- **Compatibility symlinks** - `.cursorrules`, `.github/copilot-instructions.md`
|
|
51
84
|
|
|
52
|
-
###
|
|
85
|
+
### Interactive Service Setup
|
|
53
86
|
|
|
54
|
-
|
|
55
|
-
- **llms.txt** - Padrão 2026 para indexação por LLMs (ChatGPT, Perplexity)
|
|
56
|
-
- **ARCHITECTURE.md** - Decisões arquiteturais explicadas
|
|
57
|
-
- **EXAMPLES.md** - Casos de uso com código completo
|
|
58
|
-
- **Symlinks** - `.cursorrules` e `.github/copilot-instructions.md` apontam para AGENTS.md
|
|
87
|
+
Configure integrations during project creation:
|
|
59
88
|
|
|
60
|
-
|
|
89
|
+
- **Resend** - Transactional email (3,000 emails/month free)
|
|
90
|
+
- **Google Analytics** - Site metrics (free)
|
|
61
91
|
|
|
62
|
-
|
|
92
|
+
The CLI provides:
|
|
93
|
+
- Pricing information and signup links
|
|
94
|
+
- API key validation
|
|
95
|
+
- Automatic `.env` and `.env.example` generation
|
|
96
|
+
- Direct links to documentation
|
|
63
97
|
|
|
64
|
-
|
|
65
|
-
- **Google Analytics** - Métricas do site (grátis)
|
|
98
|
+
Based on [GEO (Generative Engine Optimization)](https://gitbook.com/docs/guides/seo-and-llm-optimization/geo-guide) best practices.
|
|
66
99
|
|
|
67
|
-
|
|
68
|
-
- Mostra informações de pricing e signup
|
|
69
|
-
- Valida formato das API keys
|
|
70
|
-
- Gera `.env` e `.env.example` automaticamente
|
|
71
|
-
- Inclui links diretos para obter chaves
|
|
100
|
+
## Commands
|
|
72
101
|
|
|
73
|
-
|
|
102
|
+
```bash
|
|
103
|
+
nimbus create [name] # Create new project (interactive)
|
|
104
|
+
nimbus analyze [dir] # Analyze existing project stack
|
|
105
|
+
nimbus upgrade [target] # Plan dependency upgrades
|
|
106
|
+
nimbus update # Update CLI itself
|
|
107
|
+
nimbus setup node # Configure Node.js environment (Volta)
|
|
108
|
+
nimbus help # Show help
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## Options
|
|
74
112
|
|
|
75
|
-
|
|
113
|
+
| Flag | Description |
|
|
114
|
+
|------|-------------|
|
|
115
|
+
| `-y, --yes` | Accept defaults (skip prompts) |
|
|
116
|
+
| `--no-git` | Skip Git initialization |
|
|
117
|
+
| `--no-install` | Skip dependency installation |
|
|
118
|
+
| `--landing` | Use landing page template |
|
|
119
|
+
| `--app` | Use web app template |
|
|
120
|
+
| `--turborepo` | Use monorepo template |
|
|
76
121
|
|
|
77
|
-
|
|
122
|
+
## Examples
|
|
78
123
|
|
|
79
|
-
|
|
80
|
-
- fnm e nvm causam problemas de cache do shell
|
|
81
|
-
- Volta nao tem esse problema (binarios nativos)
|
|
82
|
-
- Funciona igual no Linux e Windows
|
|
83
|
-
- Gerencia Node, npm e pacotes globais automaticamente
|
|
124
|
+
### Landing Page (Auto Mode)
|
|
84
125
|
|
|
85
126
|
```bash
|
|
86
|
-
|
|
87
|
-
|
|
127
|
+
nimbus create portfolio --landing -y
|
|
128
|
+
cd portfolio
|
|
129
|
+
bun dev
|
|
130
|
+
```
|
|
88
131
|
|
|
89
|
-
|
|
90
|
-
|
|
132
|
+
### Web App (Interactive)
|
|
133
|
+
|
|
134
|
+
```bash
|
|
135
|
+
nimbus create dashboard --app
|
|
136
|
+
# Follow prompts for service configuration
|
|
137
|
+
cd dashboard
|
|
138
|
+
bun setup # Database setup
|
|
139
|
+
bun dev
|
|
91
140
|
```
|
|
92
141
|
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
142
|
+
### Analyze Existing Project
|
|
143
|
+
|
|
144
|
+
```bash
|
|
145
|
+
nimbus analyze ./my-project
|
|
146
|
+
nimbus analyze --json # JSON output
|
|
147
|
+
```
|
|
98
148
|
|
|
99
|
-
|
|
149
|
+
### Plan Upgrades
|
|
100
150
|
|
|
101
151
|
```bash
|
|
102
|
-
#
|
|
103
|
-
nimbus
|
|
104
|
-
nimbus
|
|
105
|
-
|
|
106
|
-
# Planejar upgrades
|
|
107
|
-
nimbus upgrade --plan
|
|
108
|
-
nimbus upgrade tailwind
|
|
109
|
-
nimbus upgrade next
|
|
152
|
+
nimbus upgrade --plan # Show available upgrades
|
|
153
|
+
nimbus upgrade tailwind # Upgrade specific package
|
|
154
|
+
nimbus upgrade next # Upgrade Next.js
|
|
110
155
|
```
|
|
111
156
|
|
|
112
|
-
##
|
|
157
|
+
## Node.js Setup (Volta)
|
|
158
|
+
|
|
159
|
+
Configure Node.js environment using [Volta](https://volta.sh).
|
|
160
|
+
|
|
161
|
+
**Why Volta?**
|
|
162
|
+
- No shell cache issues (unlike fnm/nvm)
|
|
163
|
+
- Native binaries for better performance
|
|
164
|
+
- Cross-platform (Linux, macOS, Windows)
|
|
165
|
+
- Automatic version management per project
|
|
166
|
+
|
|
167
|
+
```bash
|
|
168
|
+
# Check current environment
|
|
169
|
+
nimbus setup node --check
|
|
170
|
+
|
|
171
|
+
# Migrate to Volta (interactive)
|
|
172
|
+
nimbus setup node
|
|
173
|
+
```
|
|
113
174
|
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
175
|
+
The command will:
|
|
176
|
+
1. Detect existing fnm/nvm installations
|
|
177
|
+
2. Remove them automatically
|
|
178
|
+
3. Install Volta
|
|
179
|
+
4. Reinstall global packages
|
|
119
180
|
|
|
120
|
-
##
|
|
181
|
+
## Requirements
|
|
121
182
|
|
|
122
183
|
- [Bun](https://bun.sh) >= 1.0
|
|
123
184
|
|
|
124
185
|
```bash
|
|
186
|
+
# Linux/macOS
|
|
125
187
|
curl -fsSL https://bun.sh/install | bash
|
|
188
|
+
|
|
189
|
+
# Windows
|
|
190
|
+
powershell -c "irm bun.sh/install.ps1 | iex"
|
|
126
191
|
```
|
|
127
192
|
|
|
128
|
-
##
|
|
193
|
+
## Open Source Templates
|
|
194
|
+
|
|
195
|
+
- [create-next-landing](https://github.com/nimbuslab/create-next-landing) - Landing page template
|
|
196
|
+
- [create-next-app](https://github.com/nimbuslab/create-next-app) - Web app template
|
|
197
|
+
- [create-turborepo](https://github.com/nimbuslab/create-turborepo) - Monorepo template
|
|
198
|
+
|
|
199
|
+
## Why nimbuslab CLI?
|
|
200
|
+
|
|
201
|
+
**Modern Stack**
|
|
202
|
+
Built with the latest technologies: Next.js 16, React 19, Tailwind CSS 4. Always up-to-date.
|
|
203
|
+
|
|
204
|
+
**AI-First**
|
|
205
|
+
Documentation designed for AI coding assistants. Get better suggestions, faster onboarding.
|
|
206
|
+
|
|
207
|
+
**Zero Config**
|
|
208
|
+
Smart defaults based on industry best practices. Production-ready from day one.
|
|
209
|
+
|
|
210
|
+
**Interactive**
|
|
211
|
+
Guided setup for services and integrations. No more reading docs to get started.
|
|
212
|
+
|
|
213
|
+
**Open Source**
|
|
214
|
+
All templates are open source. Fork, customize, contribute back.
|
|
215
|
+
|
|
216
|
+
## Support
|
|
217
|
+
|
|
218
|
+
- 📖 [Documentation](https://github.com/nimbuslab/nimbus-cli)
|
|
219
|
+
- 🐛 [Issues](https://github.com/nimbuslab/nimbus-cli/issues)
|
|
220
|
+
- 💬 [Discussions](https://github.com/nimbuslab/nimbus-cli/discussions)
|
|
221
|
+
|
|
222
|
+
## License
|
|
129
223
|
|
|
130
|
-
|
|
131
|
-
- [create-next-app](https://github.com/nimbuslab/create-next-app)
|
|
132
|
-
- [create-turborepo](https://github.com/nimbuslab/create-turborepo)
|
|
224
|
+
MIT © [nimbuslab](https://nimbuslab.com.br)
|
|
133
225
|
|
|
134
|
-
|
|
226
|
+
---
|
|
135
227
|
|
|
136
|
-
|
|
228
|
+
**Created by nimbuslab** - Building digital products with design and technology.
|