@nimbuslab/cli 0.6.0 → 0.6.2
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 +31 -124
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/src/index.ts +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @nimbuslab/cli
|
|
2
2
|
|
|
3
|
-
CLI
|
|
3
|
+
CLI para criar projetos Next.js com templates modernos e prontos para producao.
|
|
4
4
|
|
|
5
5
|
## Instalacao
|
|
6
6
|
|
|
@@ -21,71 +21,60 @@ nimbus create
|
|
|
21
21
|
# Criar projeto com nome
|
|
22
22
|
nimbus create meu-projeto
|
|
23
23
|
|
|
24
|
-
# Modo automatico
|
|
24
|
+
# Modo automatico
|
|
25
25
|
nimbus create meu-projeto -y
|
|
26
26
|
|
|
27
27
|
# Ajuda
|
|
28
28
|
nimbus help
|
|
29
29
|
```
|
|
30
30
|
|
|
31
|
-
##
|
|
31
|
+
## Templates
|
|
32
32
|
|
|
33
|
-
|
|
|
34
|
-
|
|
35
|
-
|
|
|
36
|
-
|
|
|
37
|
-
|
|
|
38
|
-
| `version` | Mostrar versao |
|
|
33
|
+
| Template | Descricao | Stack |
|
|
34
|
+
|----------|-----------|-------|
|
|
35
|
+
| Landing Page | Site institucional | Next.js 16 + Tailwind 4 + shadcn/ui |
|
|
36
|
+
| Web App | Aplicacao com auth | Landing + Better Auth + Prisma |
|
|
37
|
+
| Monorepo | Multiplos apps | Turborepo + apps/packages |
|
|
39
38
|
|
|
40
|
-
|
|
39
|
+
### Flags de template
|
|
41
40
|
|
|
42
|
-
|
|
41
|
+
```bash
|
|
42
|
+
# Landing page
|
|
43
|
+
nimbus create meu-site --landing
|
|
43
44
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
45
|
+
# Web app com autenticacao
|
|
46
|
+
nimbus create meu-app --app
|
|
47
|
+
|
|
48
|
+
# Monorepo
|
|
49
|
+
nimbus create meu-monorepo --turborepo
|
|
50
|
+
```
|
|
49
51
|
|
|
50
|
-
|
|
52
|
+
## Opcoes
|
|
51
53
|
|
|
52
54
|
| Flag | Descricao |
|
|
53
55
|
|------|-----------|
|
|
54
56
|
| `-y, --yes` | Aceitar defaults |
|
|
55
57
|
| `--no-git` | Nao inicializar Git |
|
|
56
58
|
| `--no-install` | Nao instalar dependencias |
|
|
57
|
-
| `--railway` | Configurar Railway automaticamente |
|
|
58
59
|
| `--template <url>` | Usar template customizado |
|
|
59
60
|
|
|
60
|
-
|
|
61
|
+
## Exemplos
|
|
61
62
|
|
|
62
63
|
```bash
|
|
63
64
|
# Landing page rapida
|
|
64
|
-
nimbus create meu-site --
|
|
65
|
+
nimbus create meu-site --landing -y
|
|
65
66
|
|
|
66
|
-
#
|
|
67
|
-
nimbus create meu-
|
|
68
|
-
|
|
69
|
-
# Monorepo sem instalar deps
|
|
70
|
-
nimbus create meu-app --turborepo --no-install
|
|
67
|
+
# Web app sem instalar deps
|
|
68
|
+
nimbus create meu-app --app --no-install
|
|
71
69
|
|
|
72
70
|
# Template customizado
|
|
73
71
|
nimbus create projeto --template usuario/repositorio
|
|
74
72
|
```
|
|
75
73
|
|
|
76
|
-
## Tipos de Projeto
|
|
77
|
-
|
|
78
|
-
| Tipo | Descricao |
|
|
79
|
-
|------|-----------|
|
|
80
|
-
| `fast` | Landing page em 6 dias |
|
|
81
|
-
| `fast+` | SaaS completo com backend |
|
|
82
|
-
| `fast+ (monorepo)` | SaaS com Turborepo |
|
|
83
|
-
|
|
84
74
|
## Requisitos
|
|
85
75
|
|
|
86
|
-
-
|
|
87
|
-
-
|
|
88
|
-
- Acesso SSH ao repositorio de templates nimbuslab
|
|
76
|
+
- [Bun](https://bun.sh) - Runtime e package manager
|
|
77
|
+
- [Git](https://git-scm.com) - Controle de versao
|
|
89
78
|
|
|
90
79
|
### Instalando Bun
|
|
91
80
|
|
|
@@ -97,90 +86,13 @@ curl -fsSL https://bun.sh/install | bash
|
|
|
97
86
|
powershell -c "irm bun.sh/install.ps1 | iex"
|
|
98
87
|
```
|
|
99
88
|
|
|
100
|
-
##
|
|
101
|
-
|
|
102
|
-
```bash
|
|
103
|
-
# Rodar em dev
|
|
104
|
-
bun run dev
|
|
105
|
-
|
|
106
|
-
# Build
|
|
107
|
-
bun run build
|
|
108
|
-
|
|
109
|
-
# Typecheck
|
|
110
|
-
bun run typecheck
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
## Versionamento
|
|
114
|
-
|
|
115
|
-
O projeto usa [Semantic Versioning](https://semver.org/). A publicacao no npm e automatica via GitHub Actions ao fazer merge na `main`.
|
|
116
|
-
|
|
117
|
-
### Avancar versao
|
|
118
|
-
|
|
119
|
-
Antes de fazer merge para `main`, atualize a versao:
|
|
120
|
-
|
|
121
|
-
```bash
|
|
122
|
-
# Patch (0.2.9 → 0.2.10) - Bug fixes
|
|
123
|
-
npm version patch
|
|
124
|
-
|
|
125
|
-
# Minor (0.2.9 → 0.3.0) - Novas features
|
|
126
|
-
npm version minor
|
|
127
|
-
|
|
128
|
-
# Major (0.2.9 → 1.0.0) - Breaking changes
|
|
129
|
-
npm version major
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
### Fluxo de release
|
|
133
|
-
|
|
134
|
-
1. Desenvolva na branch `develop`
|
|
135
|
-
2. Avance a versao no `package.json`
|
|
136
|
-
3. Commit e push: `git push origin develop`
|
|
137
|
-
4. Merge para `main`: `git checkout main && git merge develop && git push origin main`
|
|
138
|
-
5. GitHub Actions publica automaticamente no npm via OIDC
|
|
139
|
-
|
|
140
|
-
## CI/CD - Publicacao Automatica
|
|
141
|
-
|
|
142
|
-
O projeto usa **OIDC Trusted Publishing** para publicar no npm sem tokens.
|
|
143
|
-
|
|
144
|
-
### Como funciona
|
|
145
|
-
|
|
146
|
-
1. GitHub Actions autentica via OIDC (OpenID Connect)
|
|
147
|
-
2. npm valida a identidade do workflow
|
|
148
|
-
3. Pacote e publicado sem necessidade de token
|
|
89
|
+
## Templates Open Source
|
|
149
90
|
|
|
150
|
-
|
|
91
|
+
Os templates publicos estao disponiveis em:
|
|
151
92
|
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
- Organization: `nimbuslab`
|
|
156
|
-
- Repository: `cli`
|
|
157
|
-
- Workflow: `publish.yml`
|
|
158
|
-
3. Em "Publishing access", selecione: "Require 2FA or granular token with bypass"
|
|
159
|
-
|
|
160
|
-
**No GitHub:**
|
|
161
|
-
1. Workflow em `.github/workflows/publish.yml`
|
|
162
|
-
2. Permissoes: `id-token: write` (obrigatorio para OIDC)
|
|
163
|
-
3. Node.js 24+ (versoes anteriores tem bug)
|
|
164
|
-
|
|
165
|
-
### Limitacoes (repo privado)
|
|
166
|
-
|
|
167
|
-
- `--provenance` NAO funciona em repos privados
|
|
168
|
-
- OIDC Trusted Publishing funciona normalmente
|
|
169
|
-
- Se tornar o repo publico, adicionar `--provenance` ao publish
|
|
170
|
-
|
|
171
|
-
### Troubleshooting
|
|
172
|
-
|
|
173
|
-
| Erro | Causa | Solucao |
|
|
174
|
-
|------|-------|---------|
|
|
175
|
-
| "Access token expired" | Token classico deprecado | Usar OIDC Trusted Publishing |
|
|
176
|
-
| E404 + "not in registry" | OIDC nao configurado | Configurar Trusted Publisher no npm |
|
|
177
|
-
| E422 + "private repository" | --provenance em repo privado | Remover --provenance |
|
|
178
|
-
| "id-token permission" | Falta permissao no workflow | Adicionar `id-token: write` |
|
|
179
|
-
|
|
180
|
-
### Referencias
|
|
181
|
-
|
|
182
|
-
- [npm Trusted Publishing](https://docs.npmjs.com/trusted-publishers/)
|
|
183
|
-
- [OIDC Announcement](https://github.blog/changelog/2025-07-31-npm-trusted-publishing-with-oidc-is-generally-available/)
|
|
93
|
+
- [create-next-landing](https://github.com/nimbuslab/create-next-landing) - Landing page
|
|
94
|
+
- [create-next-app](https://github.com/nimbuslab/create-next-app) - Web app com auth
|
|
95
|
+
- [create-turborepo](https://github.com/nimbuslab/create-turborepo) - Monorepo
|
|
184
96
|
|
|
185
97
|
## Stack
|
|
186
98
|
|
|
@@ -190,9 +102,4 @@ O projeto usa **OIDC Trusted Publishing** para publicar no npm sem tokens.
|
|
|
190
102
|
|
|
191
103
|
## Licenca
|
|
192
104
|
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
---
|
|
196
|
-
|
|
197
|
-
**nimbuslab** - Tecnologia que transforma
|
|
198
|
-
https://nimbuslab.com.br
|
|
105
|
+
MIT - [nimbuslab](https://nimbuslab.com.br)
|
package/dist/index.js
CHANGED
|
@@ -1567,7 +1567,7 @@ function showNextSteps(config) {
|
|
|
1567
1567
|
|
|
1568
1568
|
// src/index.ts
|
|
1569
1569
|
var PACKAGE_NAME = "@nimbuslab/cli";
|
|
1570
|
-
var CURRENT_VERSION = "0.6.
|
|
1570
|
+
var CURRENT_VERSION = "0.6.2";
|
|
1571
1571
|
var LOGO = `
|
|
1572
1572
|
\u2588\u2588\u2588\u2557 \u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557 \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557
|
|
1573
1573
|
\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D
|
package/package.json
CHANGED
package/src/index.ts
CHANGED