Express Craft CLI

🚀 A powerful CLI tool to scaffold Express.js applications with best practices and modern tooling.

🌐 Languages | Idiomas

• English: README.md (current)
• Español: README.es.md

Features

• ✨ Interactive Mode - Guided project creation with prompts
• 🛡️ Dependency Strategies - Choose between stable, latest, or experimental versions
• 📦 Smart Installation - Automatic npm install with robust error handling
• 🔧 Modern Setup - ES Modules, ESLint-ready, and development-focused
• 🏗️ Clean Architecture - Well-structured project templates
• 🚫 Flexible Development - Optional nodemon (can use Node.js --watch instead)
• 🧪 Testing Support - Built-in test suite and --no-install option for testing

Installation

Global Installation (Recommended)

npm install -g express-craft

Local Development

git clone https://github.com/Adan-Perez/express-craft-cli.git
cd express-craft-cli
npm install
npm link

Usage

Basic Usage

# Interactive mode
express-craft

# Direct project creation
express-craft my-app

# With dependency strategy
express-craft my-app --latest
express-craft my-app --stable

Options

Option	Description
--latest	Use latest versions of dependencies (experimental)
--stable	Use stable/tested versions (default)
--no-install	Skip npm install (useful for testing)
--no-nodemon	Skip nodemon installation (use Node.js --watch)
--fetch-versions	Fetch latest stable versions from npm (slower)
--help	Show help information
--version	Show version number

Examples

# Create a new project with stable dependencies
express-craft my-api --stable

# Create a project with latest dependencies
express-craft bleeding-edge-app --latest

# Create project structure only (no npm install)
express-craft test-project --no-install

# Create project without nodemon (uses Node.js --watch)
express-craft minimal-app --no-nodemon

# Create project with latest stable versions from npm
express-craft current-app --fetch-versions

Generated Project Structure

my-app/
├── package.json         # Dependencies and scripts
├── app.js               # Main Express application
├── README.md            # Project documentation
└── node_modules/        # Dependencies (if installed)

Generated Files

• package.json - Configured with Express, Nodemon, and proper scripts
• app.js - Basic Express server with JSON middleware and sample route
• README.md - Project-specific documentation with getting started guide

Contributing

📋 Documentation:

• CONTRIBUTING.md - English
• CONTRIBUTING.es.md - Español

License

-LICENSE - This project is licensed under the MIT License.

Changelog

📜 Change History:

• CHANGELOG.md - English
• CHANGELOG.es.md - Español

All notable changes to this project are documented in the changelog files.

---

Made with ❤️ for the Node.js community