Generators (Legacy)

These generators exist because Nestled was originally designed as a "generate from scratch" tool. In practice, cloning the template and running pnpm db-update is faster, easier, and keeps you on a supported upgrade path. The generators below are preserved as a reference for understanding what each piece of the template does.

@nestledjs/config

Configuration and workspace setup generators.

config:setup

nx g @nestledjs/config:setup

Updates tsconfig.base.json with required compiler options (decorator metadata, ESNext modules, node module resolution). Installs base dev dependencies including Prisma, Prettier, and ESLint.

config:init

nx g @nestledjs/config:init

Creates the project configuration files:

• .prettierrc and .prettierignore
• .env.example and .env
• .dev/Dockerfile and .dev/docker-compose.yml (PostgreSQL, Redis, Mailhog)
• pnpm-workspace.yaml
• Adds all npm scripts to package.json (docker, prisma, build, dev, format, lint, test, etc.)

@nestledjs/api

API scaffolding generators for NestJS + GraphQL.

api:setup

nx g @nestledjs/api:setup

Installs all API dependencies — NestJS, Apollo Server, GraphQL, Prisma, Passport, bcrypt, nodemailer, Redis, and many more. This is the foundation that all other API generators depend on.

api:app

nx g @nestledjs/api:app

Scaffolds the NestJS application in apps/api/ with:

• main.ts with security middleware (Helmet, CORS, cookie parsing)
• app.module.ts with module composition
• Webpack configuration for Node builds
• dev:api script in package.json

api:prisma

nx g @nestledjs/api:prisma

Creates the Prisma library at libs/api/prisma/ with:

• schema.prisma template
• prisma.config.ts at workspace root
• Seed files with initial data and ISO 3166 countries
• All prisma:* scripts in package.json
• The db-update script that orchestrates the full code generation pipeline

Options: --overwrite (default: false) — overwrite existing files

api:config

nx g @nestledjs/api:config

Creates the API configuration library at libs/api/config/ with data-access and feature layers for environment variable management and app settings.

Options: --overwrite (default: false)

api:core

nx g @nestledjs/api:core

Creates the core framework libraries at libs/api/core/ with four layers:

• data-access — CoreService extending Prisma, PubSub setup, shared DTOs (paging, multi-select)
• feature — CoreResolver and module, Apollo Server configuration
• models — GraphQL type generation from Prisma schema (via generate-models.ts)
• helpers — GraphQL utility functions

Also installs GraphQL plugins for query complexity analysis, no-cache directives, and request logging.

Options: --overwrite (default: false), --cookieName (default: "__session")

api:utils

nx g @nestledjs/api:utils

Creates the utility library at libs/api/utils/ with:

• @CtxUser() decorator — extracts the authenticated user from WebSocket or HTTP context
• GqlAuthGuard — requires any authenticated user
• GqlAuthAdminGuard — requires a super admin user
• NestContext type definition

api:smtp-mailer

nx g @nestledjs/api:smtp-mailer

Creates the SMTP mailer service library at libs/api/smtp-mailer/data-access/ for sending emails via Nodemailer.

api:user

nx g @nestledjs/api:user

Creates user management libraries with data-access and feature layers for user operations.

api:account

nx g @nestledjs/api:account

Creates account management libraries with:

• data-access — account service, DTOs for profile updates, password changes, email management
• feature — account resolver and module

@nestledjs/web

Frontend generators for React + React Router 7.

web:setup

nx g @nestledjs/web:setup

Installs frontend dependencies — React 19, React Router 7, Vite, Tailwind CSS 4, Apollo Client 4, and related packages.

web:app

nx g @nestledjs/web:app

Scaffolds the React application at apps/web/ with:

• Vite development server
• React Router 7 with SSR and file-based routing
• Vitest for unit testing
• dev:web, typecheck, and typecheck:watch scripts

@nestledjs/shared

shared:apollo

nx g @nestledjs/shared:apollo

Creates the Apollo Client configuration library at libs/shared/apollo/ with client setup, auth middleware, and cache configuration.

shared:styles

nx g @nestledjs/shared:styles

Creates the shared styles library at libs/shared/styles/ with the Tailwind CSS import.

@nestledjs/plugins

Plugin generators for complex features.

plugins:auth

nx g @nestledjs/plugins:auth --name auth

Creates a complete authentication system at libs/api/custom/src/lib/plugins/auth/:

• Services — auth service, session service, OAuth service, 2FA helper
• Resolver — GraphQL mutations for register, login, logout, password reset, email verification
• JWT strategy — Passport JWT with session validation
• DTOs — register, login, forgot-password, reset-password, verify-email, invite-user
• Email templates — verification, password reset, organization invite

Registers AuthModule in app.module.ts.

plugins:integration

nx g @nestledjs/plugins:integration --name smtp-mailer

Creates an integration module at libs/api/integrations/ for external service connections. Currently supports smtp-mailer as the integration name.

Generator execution order

For reference, this is the full order used to build the template from scratch. You don't need to run these — they've already been run for you.

# 1. Configuration
nx g @nestledjs/config:setup
nx g @nestledjs/config:init

# 2. API infrastructure
nx g @nestledjs/api:setup
nx g @nestledjs/api:app
nx g @nestledjs/api:prisma
nx g @nestledjs/api:config
nx g @nestledjs/api:core
nx g @nestledjs/api:custom

# 3. API services
nx g @nestledjs/api:smtp-mailer
nx g @nestledjs/api:generate-crud
nx g @nestledjs/api:utils
nx g @nestledjs/api:custom          # Run again to pick up generated models

# 4. Shared libraries
nx g @nestledjs/shared:sdk
nx g @nestledjs/shared:styles

# 5. Authentication
nx g @nestledjs/plugins:auth

# 6. Integrations
nx g @nestledjs/api:integrations
nx g @nestledjs/plugins:integration --name smtp-mailer

# 7. Post-generation setup
nx g @nestledjs/api:workspace-setup

# 8. Frontend
nx g @nestledjs/web:setup
nx g @nestledjs/web:app
nx g @nestledjs/shared:apollo