nestjs-clean-typescript

Guidelines by Alberto Basalo for developing clean NestJS APIs using TypeScript. These rules emphasize strong typing, clean code principles, and architectural best practices.

TypeScript General Principles

• Always declare the type of each variable and function (parameters and return value)
• Avoid using any; create necessary types instead
• Use JSDoc for public classes and methods
• One export per file

Naming Conventions

• PascalCase for classes
• camelCase for variables and functions
• kebab-case for files and directories
• UPPERCASE for environment variables
• Boolean variables use prefixes: isX, hasX, canX

Function Design

• Write short functions with a single purpose. Less than 20 instructions
• Use early returns to avoid nesting
• Apply RO-RO pattern: pass objects for multiple parameters, return objects for results

Data and Classes

• Prefer immutability for data with readonly and as const
• Follow SOLID principles
• Classes should have:
  • Less than 200 instructions
  • Fewer than 10 public methods
  • Fewer than 10 properties

NestJS Specific Guidelines

• Use modular architecture with one module per domain/route
• Use MikroORM entities for persistence
• One service per entity
• DTOs validated with class-validator
• Global filters, middlewares, guards, and interceptors in core module

Testing

• Use Jest framework
• Follow Arrange-Act-Assert convention
• Write unit tests for each public function
• Include end-to-end tests per API module