Skip to content

Releases: Adan-Perez/express-craft-cli

v0.2.0

15 Jun 21:47
@Adan-Perez Adan-Perez
v0.2.0
0a7f24c

Choose a tag to compare

View all tags
v0.2.0 Latest
Latest

🔄 JavaScript → TypeScript Migration

Complete migration to TypeScript with 100% backward compatibility for end users.

✨ What's New

  • 🟦 Full TypeScript implementation with strict typing
  • 📁 Modern structure: src/core/, src/utils/, src/types/
  • 📦 Optimized package: 19.7 kB with complete documentation
  • 🗂️ Legacy preserved: Original JS code in legacy/ folder
  • ✅ All tests passing: 13/13

🚀 For Users

No changes needed! Install and use exactly as before:

npm install -g @adandev/express-craft
express-craft my-project
Assets 2
Loading

v0.1.0 - Initial Release

13 Jun 21:31
@Adan-Perez Adan-Perez
v0.1.0
dac6978

Choose a tag to compare

View all tags
v0.1.0 - Initial Release

🚀 Express Craft CLI v0.1.0 - Initial Release

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

✨ 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, development-focused configuration
  • 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
  • Bilingual Documentation - English and Spanish documentation

📦 Installation

npm install -g express-craft

🚀 Quick Start

# Interactive mode
express-craft

# Direct project creation
express-craft my-app

# With options
express-craft my-app --latest --no-nodemon

🎯 Available 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

🧪 What's Included

  • 13 comprehensive tests covering all functionality
  • Bilingual documentation (English/Spanish)
  • Professional error handling and user feedback
  • Modern ES Modules configuration
  • HTTP timeout protection for npm registry requests
  • Flexible project name validation

📋 Generated Project Structure

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

🔧 Technical Details

Requirements

  • Node.js >= 22.0.0

Dependencies

  • chalk ^5.4.1 - Terminal colors and styling
  • commander ^14.0.0 - Command-line interface framework
  • fs-extra ^11.3.0 - Enhanced file system operations
  • inquirer ^9.2.0 - Interactive command-line prompts
  • ora ^8.2.0 - Loading spinners and progress indicators

Generated Project Features

  • Modern ES Modules configuration
  • Express.js server with JSON middleware
  • Sample API endpoint (GET /)
  • Development scripts (start, dev)
  • Optional nodemon for development
  • Proper package.json with metadata

🌟 Highlights

Developer Experience

  • Colorful interface with emojis and clear messaging
  • Real-time feedback with loading spinners
  • Helpful error messages with actionable suggestions
  • Comprehensive help system with examples

Code Quality

  • 100% test coverage of core functionality
  • Zero security vulnerabilities (verified with npm audit)
  • Clean, modular architecture with separation of concerns
  • Professional error handling throughout the application

Documentation

  • Complete README in both English and Spanish
  • Contribution guidelines for open source collaboration
  • Detailed changelog tracking all changes
  • MIT License for maximum compatibility

🔄 Future Roadmap

See TODO.md for planned features including:

  • Additional project templates (TypeScript, REST API, GraphQL)
  • Database integration options
  • Docker support
  • Plugin system for extensibility

📄 License

MIT License - see LICENSE for details.

🙏 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Full Changelog: This is the initial release

Download: Use the assets below to download the source code, or install via npm:

npm install -g express-craft
Loading