Generate command

Scaffold a fully wired feature module — model, validation, service, controller and routes — with one command.

Inside a generated project, npm run generate scaffolds a complete feature module that follows the project's conventions and auto-mounts immediately.

npm run generate product

What it creates#

Five files, ready to extend:

✓ src/models/product.model.ts
✓ src/modules/product/product.validation.ts
✓ src/modules/product/product.service.ts
✓ src/modules/product/product.controller.ts
✓ src/modules/product/product.routes.ts   → mounted at /product

Because of the auto route loader, the new routes are live the moment you save — no registration step.

The module pattern#

Every generated module separates concerns the same way:

• validation — Joi schemas only. Used by validateBody / validateQuery middleware and read by the docs generator.
• service — business logic and database queries. No HTTP objects here, so it's easy to test and reuse.
• controller — thin HTTP handlers, written as plain async functions.
• routes — the router and its middleware chain.

// product.service.ts — pure logic, HTTP-free
import { Product } from '@/models/product.model.js';
 
export const createProduct = (data) => Product.create(data);

Flags#