Assemble coherent Next.js projects — theming, shadcn, flows, AI-bridled.
Status: Jalon 1 — fondations posées. Commandes métier à venir.
- Bun ≥ 1.2
bun install
bun link # exposes `forge` globallyYou can now invoke the CLI from anywhere:
forge --help
forge --versionOr without linking, from this repo:
bun run dev -- --help| Script | Purpose |
|---|---|
bun run dev |
Run the CLI from source |
bun run build |
Bundle into dist/ (Bun runtime required) |
bun run build:compile |
Compile to a standalone binary (dist/forge) |
bun run test |
Run all tests with Bun's test runner |
bun run test:watch |
Re-run tests on change |
bun run lint |
Biome lint |
bun run lint:fix |
Biome lint with auto-fix |
bun run format |
Biome format |
bun run typecheck |
Strict tsc --noEmit |
bun run ci |
Full CI suite locally (typecheck + lint + test) |
src/
├── cli.ts # Entry point, argv parsing, top-level error handler
├── commands/ # One file per subcommand (init, theme, add, magic)
├── services/ # Business logic (config, theming, github, ai, ...)
├── adapters/ # External I/O wrappers (Handlebars, Octokit, AI SDK)
├── lib/ # Cross-cutting helpers (errors, logger, fs-safe, prompts)
├── schemas/ # Zod schemas (forge-config, manifest, theme)
└── templates/ # Bundled Handlebars templates (jalons 2+)
tests/ # Mirrors the src/ layout
.github/workflows/ # CI pipelines
| Variable | Effect |
|---|---|
FORGE_DEBUG=1 |
Same as passing --debug to every command |
FORGE_LOG=debug |
Verbose logging |
FORGE_LOG=silent |
Suppress everything except errors |
- Jalon 1 — Fondations CLI ✅
- Jalon 2 — Moteur de Theming
- Jalon 3 — Architecture Next.js (
forge init) - Jalon 4 — Registre GitHub
- Jalon 5 — Génération de Flows
- Jalon 6 — Mode Magic IA
See forge-cli-specs.md for the full specification.
UNLICENSED — internal project, all rights reserved.