Skip to content
kouadioaboagyePublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

The Forge CLI

Assemble coherent Next.js projects — theming, shadcn, flows, AI-bridled.

Status: Jalon 1 — fondations posées. Commandes métier à venir.

Requirements

Install (local development)

bun install
bun link              # exposes `forge` globally

You can now invoke the CLI from anywhere:

forge --help
forge --version

Or without linking, from this repo:

bun run dev -- --help

Scripts

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)

Project layout

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

Environment variables

Variable Effect
FORGE_DEBUG=1 Same as passing --debug to every command
FORGE_LOG=debug Verbose logging
FORGE_LOG=silent Suppress everything except errors

Roadmap (current milestone in bold)

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

License

UNLICENSED — internal project, all rights reserved.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages