nestjs

NestJS Framework with Drizzle ORM packages a set of production-oriented patterns for building server-side applications with NestJS and the Drizzle ORM. It targets teams standing up REST APIs or GraphQL servers who want a consistent structure for data access, request validation, authentication, and testing rather than assembling those conventions from scratch. The core workflow installs Drizzle and its tooling (drizzle-orm and pg, plus drizzle-kit and tsx as dev dependencies), defines table schemas in src/db/schema.ts, and exposes the Drizzle client through a DatabaseService NestJS provider.

Application code follows a Controller to Service to Repository layering. Controllers accept class-validator DTOs enforced by a global ValidationPipe, services hold business logic, and repositories issue Drizzle queries such as select, insert with returning, and multi-statement transactions for operations that must stay atomic. Route protection is handled with guards, including a JWT authentication guard that verifies a bearer token and attaches the decoded user to the request, and a Roles guard that must run after it. Unit tests use the @nestjs/testing module with repositories replaced by Jest mocks, so services can be verified in isolation. Database changes flow through drizzle-kit generate to produce migration SQL, a manual review of that SQL, and drizzle-kit migrate to apply it.

The skill also encodes guardrails: always validate inputs with DTOs instead of accepting raw objects, keep transactions short and avoid nesting them, never hardcode DATABASE_URL or JWT_SECRET, regenerate migrations after any schema change, and prefer restructuring modules over leaning on forwardRef for circular dependencies. Additional material is split into reference files covering core patterns, guards, interceptors, microservices with TCP or Redis transport, and GraphQL integration, plus a dedicated Drizzle reference and a workflow-optimization guide. Use it when scaffolding new modules, adding JWT-based auth, wiring database access, or setting up microservices in a NestJS codebase.