EZ CLI

Scaffold production-ready, enterprise-grade backend and full-stack Node.js applications with best practices built-in within minutes.

EZ CLI is a complete, developer-friendly project generator similar to create-next-app or shadcn-cli but dedicated to backend clean architectures. The generated code features strict TypeScript configuration, dependency injections, logging wrappers, global error structures, validation middleware, test suites, Docker setup, and GitHub Action pipelines out of the box.

Core Philosophy

Stop wasting time writing boilerplate configurations. Focus only on writing business logic.

Command Quick Reference

Install and execute in one command:

npx ez create my-app

Or run commands globally:

npm install -g ez
ez create

🛠️ Interactive Setup Wizard

The create command initiates a wizard questioning:

• Project Name: Folder name to scaffold.
• Framework: Express, NestJS structure, or Fastify.
• Database: PostgreSQL, MongoDB, MySQL, or SQLite.
• ORM: Prisma, Drizzle, or Mongoose / TypeORM.
• Authentication Strategy: JWT, OAuth, Session, or Magic Link.
• Email Verification: Enable verification workflows (SMTP).
• Swagger Documentation: Enable OpenAPI / Swagger routes.
• Redis Cache: Integrate a standard Redis client database cache.
• Docker Support: Generate standard Dockerfile and docker-compose.yml.
• Testing Runner: Configure testing suite using Vitest or Jest.
• Validation: Schema assertions with Zod, Joi, or Yup.
• Package Manager: Initialize setup with npm, pnpm, yarn, or bun.

🔌 Commands Index

| Command | Description | |---|---| | ez create [name] | Run setup wizard and generate base application | | ez add <plugin> | Install and configure a plugin (e.g. stripe, redis, ai) | | ez generate resource <name> | Generate CRUD models, controllers, services, repositories, schemas, and tests | | ez generate <blueprint.yml> | Forge complete project from YAML or JSON blueprints | | ez doctor | Run environmental diagnostics checks (node, docker, git) | | ez update | Check CLI version and project updates | | ez plugins | List all supported plugins with description and install guidelines | | ez deploy | Configure deployment configuration profiles (Render, Railway, Fly.io, PM2, Nginx) | | ez docs | Generate developer docs (API specifications, Architecture manual) | | ez env | Audit environmental variable configurations in .env | | ez auth | Show security setups, JWT parameters, and authentication endpoints | | ez db | Manage migrations, generate schemas, or launch GUI Studios | | ez ui | Scaffold a connected React/Vite front-end application folder | | ez ai | Ask AI helper to parse prompts and generate matching CRUD schemas | | ez payment | Set up payment integrations (Stripe / Razorpay) | | ez upload | Set up upload managers (Multer + Cloudinary) | | ez cache | Set up caching structures (Redis cache client) |

🏗️ CRUD Generator

Generate code following the Repository Pattern and clean architecture separations:

ez generate resource Product

This generates:

• Controller: src/controllers/product.controller.ts
• Service: src/services/product.service.ts
• Repository: src/repositories/product.repository.ts
• Model / Database schema: Automatically appends model to schema.prisma or creates a Mongoose schema
• Validation Schema: src/validators/product.validator.ts
• Routes Registration: Mounts /api/products endpoints inside src/routes/index.ts
• TypeScript Types: src/types/product.ts
• Unit Tests: src/tests/product.spec.ts

🤖 AI Modules Generator

If offline, EZ CLI runs semantic rules-based parsing of your request. If GEMINI_API_KEY is configured in your environment variables, it calls Google Gemini models to parse descriptions and outputs fully operational schemas:

ez ai
# Prompt: "Build a travel booking system with flights, hotels, and bookings"

📄 Blueprint System

Scaffold entire applications from structured YAML or JSON blueprints:

project:
  name: TravelBookingApp
  framework: express
  database: postgres
  orm: prisma
  auth: jwt
  docker: true
  testing: vitest
  validation: zod
  packageManager: npm
entities:
  - Flight
  - Hotel
  - Booking
features:
  - redis
  - payment
  - upload

Forging the blueprint:

ez generate blueprint.yml

License

MIT