create-hybrid-mvc

Scaffold a production-ready BFF-led modular monolith in seconds — the same way create-next-app scaffolds Next.js.

npx create-hybrid-mvc@latest my-app

That's it. One command copies the boilerplate, runs git init, and installs dependencies. Then:

cd my-app
npm run dev

Your API is live on http://localhost:3000.

What you get

A hybrid-mvc-microservice-nodejs project, wired and ready:

• 🧭 BFF-led architecture — one public API surface, internal modules reached only through the BFF proxy layer.
• 🧩 Module generator — npm run create:module -- payment scaffolds a full module (routes, handlers, services, models, schema) and its BFF client, wired into every index automatically.
• 🗄️ Lazy data clients — Redis, Postgres, and Mongo connect only when used, via the shared @wetech-code_official/common-lib.
• ✅ Batteries included — TypeScript, ESLint, Prettier, Husky pre-commit hooks, and enforced import boundaries out of the box.
• 📚 Docs bundled — architecture, request flow, and module-creation guides live in docs/.

No domain modules ship by default — you generate exactly what you need.

Interactive prompt

Run it without a name and it asks:

npx create-hybrid-mvc@latest
# ? Project name › my-app

Options

| Flag | Description | | --------------------- | -------------------------------------- | | [project-directory] | Target folder (prompted if omitted) | | --no-git | Skip git init and the initial commit | | --no-install | Skip npm install | | -h, --help | Show usage | | -v, --version | Print the CLI version |

Requirements

• Node.js ≥ 20
• npm (pnpm/yarn/bun not supported in v1)

After scaffolding

cd my-app
npm run dev                         # start the dev server
npm run create:module -- payment    # generate your first module
npm run quality                     # typecheck + lint + format check

Full guide: docs/README.md inside your new project.

License

MIT