ezyExpress-CLI🚀

exyExpres — Fast & Simple Express.js Project Generator CLI

---

Table of Contents

1. Overview
2. Installation
3. Usage
4. CLI Commands
5. Project Folder Structure
6. Templates
7. Configuration
8. Contribution
9. License
10. Roadmap

---

Overview

Celexpress is a CLI tool for quickly scaffolding Express.js projects. It provides Artisan-style commands to generate controllers, models, routes, and middlewares with ease.

• Fast project setup
• Interactive prompts
• JS & TypeScript support
• Modular and extendable CLI

---

Installation

Run via npx (no install required):

npx ezyexpres

Global installation (optional):

npm install -g ezyexpres
cex

cex is the CLI shortcut for Celexpress commands.

---

Usage

Create a new project

ezyexpres create my-app

Interactive prompts:

📂 Project name? my-app
📝 Use TypeScript? (y/N) n
📁 Select folders: routes, controllers, models, middlewares, services

Generate files

# Generate a controller
ezyexpres make:controller UserController

# Generate a model
ezyexpres make:model User

# Generate a route
ezyexpres make:route user

# Generate middleware
ezyexpres make:middleware auth

# Generate service
ezyexpres make:service UserService

---

CLI Commands

Command	Description
ezyexpres create <project-name>	Scaffold a new Express project
ezyexpres make:controller <name>	Generate a controller file
ezyexpres make:model <name>	Generate a model file
ezyexpres make:route <name>	Generate a route file
ezyexpres make:middleware <name>	Generate middleware file
ezyexpres make:service <name>	Generate service file
ezyexpres --help	List all commands

---

Project Folder Structure

celexpress/
├── bin/
│   └── celexpress.js
├── commands/
│   ├── create.js
│   ├── makeController.js
│   ├── makeModel.js
│   ├── makeRoute.js
│   └── makeMiddleware.js
├── templates/
│   ├── js/
│   │   ├── server.js
│   │   ├── controller.js
│   │   └── route.js
│   └── ts/
│       ├── server.ts
│       ├── controller.ts
│       └── route.ts
├── utils/
│   └── fileHelpers.js
├── config/
│   └── defaultConfig.json
├── package.json
├── README.md
├── .gitignore
└── LICENSE

---

Templates

JS Templates (templates/js/)

• server.js → basic Express server
• controller.js → sample controller
• route.js → basic route

TS Templates (templates/ts/)

• server.ts → TypeScript server
• controller.ts → TypeScript controller
• route.ts → TypeScript route

---

Configuration

Default configuration file: config/defaultConfig.json

{
  "useTypeScript": false,
  "defaultFolders": ["routes","controllers","models","middlewares","services","config","utils"]
}

---

Contribution

1. Fork the repository
2. Clone locally: git clone https://github.com/<USERNAME>/celexpress.git
3. Install dependencies: npm install
4. Create a new branch for your feature: git checkout -b feature/<name>
5. Commit your changes and submit a pull request

---

License

MIT License © 2026

---

Roadmap

• v1.0: JS scaffolding, basic make commands
• v1.1: TypeScript support, auto .env creation, middleware templates
• v1.2: Database scaffolding, logging setup
• v2.0: Plugin system, multi-framework support

---

ezyExpres-cli — Fast & Simple Express.js Project Generator CLI