Express CLI Generator

A powerful CLI tool for generating Express.js API modules, controller, service, route and DTOs with standardized structure and automatic file management.

Features

• Generate complete API modules with controllers, services, routes, and DTOs
• Generate individual Data Transfer Objects (DTOs), Controller, Route, Service
• Automatic file conflict detection and replacement prompts
• Kebab-case naming convention
• Template-based code generation
• Interactive prompts with validation

Installation

npm install -g xpresss-cli

Usage

Interactive Mode

xpresss-cli generate

This will prompt you to select what you want to generate and provide the necessary inputs.

Direct Commands

Generate a Module

# Interactive prompt for module name
xpresss-cli generate --type module

# Specify module name directly
xpresss-cli generate --type module --name user

Generate a Controller

# Interactive prompt for controller name
xpresss-cli generate --type controller

# Specify Controller name directly
xpresss-cli generate --type controller --name user

Generate a service

# Interactive prompt for service name
xpresss-cli generate --type service

# Specify service name directly
xpresss-cli generate --type service --name user

Generate a route

# Interactive prompt for route name
xpresss-cli generate --type route

# Specify route name directly
xpresss-cli generate --type route --name user

Generate a DTO

# Interactive prompt for DTO name
xpresss-cli generate --type dto

# Specify DTO name directly
xpresss-cli generate --type dto --name user

Generated Structure

Module Structure

When you generate a module named "user", the following files are created:

src/modules/user/
├── controllers/
│   └── user.controller.ts
├── services/
│   └── user.service.ts
├── routes/
│   └── user.route.ts
├── dtos/
│   └── user.dto.ts
└── index.ts

CLI Options

| Option | Short | Description | Example | | -------- | ----- | -------------------------------------------------------------- | --------------- | | --type | -t | Specify generator type (module/controler, service, route, dto) | --type module | | --name | -n | Specify the name directly | --name user |

Examples

Generate a complete user module

xpresss-cli generate --type module --name user

Creates:

• src/modules/user/controllers/user.controller.ts
• src/modules/user/services/user.service.ts
• src/modules/user/routes/user.route.ts
• src/modules/user/dtos/user.dto.ts
• src/modules/user/index.ts

Generate only a DTO

xpresss-cli generate --type dto --name product

Creates:

• src/modules/product/dtos/product.dto.ts

Interactive generation

xpresss-cli generate

1. Select what to generate (module or DTO)
2. Enter the name
3. Confirm file replacement if conflicts exist

Dependencies

• node-plop: Template-based file generator
• inquirer: Interactive command line prompts
• commander: Command-line interface framework

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

MIT License