create-forgeon

CLI package for generating Forgeon fullstack monorepo projects.

[!WARNING] Pre-release package. Do not use in production before 1.0.0. The project is under active development: each patch can add changes and may introduce breaking regressions.

Usage

npx create-forgeon@latest my-app --i18n true --db-prisma true --proxy caddy
npx create-forgeon@latest my-app --db-prisma false --proxy caddy

If flags are omitted, the CLI asks interactive questions. Project name stays text input; fixed-choice prompts use arrow-key selection (Up/Down + Enter).

npx create-forgeon@latest add --list
npx create-forgeon@latest add i18n --project ./my-app
npx create-forgeon@latest add jwt-auth --project ./my-app
npx create-forgeon@latest add files --with-required --provider db-adapter=db-prisma

cd my-app
pnpm forgeon:sync-integrations

Notes

• Canonical runtime stack is fixed: NestJS + React + Docker.
• DB is module-driven: db-prisma is default-on and can be disabled at scaffold time.
• Reverse proxy options: caddy (default), nginx, none.
• add i18n is implemented and applies backend/frontend i18n wiring.
• add jwt-auth is implemented and auto-detects DB adapter support for refresh-token persistence.
• Integration sync is bundled by default and runs after add commands (best-effort).
• Module notes are written under modules/<module-id>/README.md.
• Hard prerequisites are explicit:
  • TTY mode prompts for provider resolution and install plan confirmation
  • non-TTY mode can use --with-required plus --provider <capability>=<module>