create-enterprise-nestjs

create-enterprise-nestjs

Enterprise-grade NestJS boilerplate generator with three-layer architecture.

Installation

npm install -g create-enterprise-nestjs

Usage

npx create-enterprise-nestjs my-app

Or with project name:

npx create-enterprise-nestjs my-app

Generated Project Setup

After generating your project, you have two options:

Option 1: Using Docker (Recommended)

cd my-app

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your database configuration

# Start Docker services
npm run docker:up

# Setup database
npm run db:create
npm run db:migrate

# Enable DatabaseModule in src/app.module.ts
# Uncomment: DatabaseModule, // Uncomment after setting up database configuration

# Start development server
npm run start:dev

Option 2: Local Database Installation

If you prefer to install MySQL/PostgreSQL locally:

cd my-app

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your local database configuration
# Update DB_HOST to 'localhost' or your database host

# Install and configure your database locally
# Then create the database manually or use:
npm run db:create
npm run db:migrate

# Enable DatabaseModule in src/app.module.ts
# Uncomment: DatabaseModule, // Uncomment after setting up database configuration

# Start development server
npm run start:dev

Note: Docker commands will gracefully fail if Docker is not available, allowing you to use local database installations instead.

Features

• Three-layer architecture (Controller → Service → Repository)
• JWT authentication with role-based access control
• Sequelize ORM with MySQL/PostgreSQL support
• Swagger/OpenAPI documentation
• Winston logging with file rotation
• Docker Compose setup
• TypeScript strict mode
• Enterprise-grade error handling

Generated Structure

my-app/
├── src/
│   ├── common/          # Shared utilities
│   ├── config/         # Configuration
│   ├── database/        # Sequelize setup
│   └── modules/        # Feature modules
├── docker-compose.yml
└── package.json

License

MIT