nestjs_skill

Overview

This skill provides comprehensive, example-driven guidance for building and maintaining NestJS applications using patterns from the official documentation. It covers core architecture (controllers, providers, modules), middleware and lifecycle hooks, and advanced topics like GraphQL, microservices, WebSockets, OpenAPI/Swagger, security, and testing. Use it to scaffold features, follow best practices, and adapt templates to your project.

How this skill works

When you specify a NestJS topic, the skill maps your request to the corresponding example file that mirrors the official docs structure. Examples include TypeScript and JavaScript snippets, configuration notes, and links to the authoritative docs. Templates for controllers, providers, modules, middleware, guards, pipes, interceptors, DTOs, and project scaffolding accelerate common tasks and ensure consistent patterns.

When to use it

• Starting a new NestJS project or scaffolding feature modules
• Implementing or refactoring controllers, providers, modules, or DI scopes
• Adding middleware, pipes, guards, interceptors, or exception filters
• Integrating GraphQL, WebSockets, microservices, or message brokers
• Documenting APIs with OpenAPI/Swagger and securing endpoints
• Writing unit tests and end-to-end (E2E) tests or following testing recipes

Best practices

• Leverage NestJS dependency injection for testability and clear boundaries
• Organize code by feature modules to keep concerns isolated
• Use DTOs and ValidationPipe for robust input validation and sanitization
• Apply guards for authorization and global exception filters for consistent errors
• Use interceptors for logging, transformation, and response shaping
• Prefer TypeScript and follow official decorator patterns for consistency

Example use cases

• Scaffold a REST controller with DTOs, validation, and basic unit tests
• Refactor a monolithic app into feature modules with shared services
• Add GraphQL resolvers, subscriptions, and type-safe schemas
• Build a microservice using Redis/Kafka/NATS and a hybrid HTTP/microservice app
• Expose API docs using Swagger and secure endpoints with JWT/guards