CLI Overview

Welcome to the comprehensive documentation for the Wheels CLI - a powerful command-line interface for the Wheels framework.

What is Wheels CLI?

Wheels CLI is a CommandBox module that provides a comprehensive set of tools for developing Wheels applications. It offers:

• Code Generation - Quickly scaffold models, controllers, views, and complete CRUD operations

• Database Migrations - Manage database schema changes with version control

• Testing Tools - Run tests, generate coverage reports, and use watch mode

• Development Tools - File watching, automatic reloading, and development servers

• Code Analysis - Security scanning, performance analysis, and code quality checks

• Plugin Management - Install and manage Wheels plugins

• Environment Management - Switch between development, testing, and production

Documentation Structure

📚 Command Reference

Complete reference for all CLI commands organized by category:

• Core Commands - Essential commands like init, reload, watch

• Code Generation - Generate applications, models, controllers, views

• Database Commands - Migrations and database management

• Testing Commands - Run tests and generate coverage

• Configuration - Manage application settings

• And more...

🚀 Quick Start Guide

Get up and running with Wheels CLI in minutes. Learn how to:

• Install Wheels CLI

• Create your first application

• Generate CRUD scaffolding

• Run tests and migrations

📖 Guides

Development Guides

• Service Architecture - Understand the CLI's architecture
• Creating Custom Commands - Extend the CLI with your own commands
• Template System - Customize code generation templates
• Testing Guide - Write and run tests effectively

Best Practices

• Migration Guide - Database migration best practices
• Security Guide - Security scanning and hardening
• Performance Guide - Optimization techniques

📋 Reference

• Configuration Options - All available configuration settings
• Template Variables - Variables available in templates
• Exit Codes - Understanding command exit codes
• Environment Variables - Environment configuration

Key Features

🛠️ Code Generation

Generate complete applications or individual components:

# Create new application
wheels new blog

# Generate complete CRUD scaffolding
wheels scaffold post --properties="title:string,content:text,published:boolean"

# Generate individual components
wheels generate model user
wheels generate controller users --rest
wheels generate view users index

🗄️ Database Migrations

Manage database schema changes:

# Create migration
wheels dbmigrate create table posts

# Run migrations
wheels dbmigrate latest

# Check status
wheels dbmigrate info

🧪 Testing

Comprehensive testing support:

# Run all tests
wheels test run

# Watch mode
wheels test run --watch

# Generate coverage
wheels test coverage

👀 Development Tools

Enhance your development workflow:

# Watch for file changes
wheels watch

# Reload application
wheels reload development

# Analyze code
wheels analyze code
wheels security scan

Getting Started

1. Install CommandBox (if not already installed):

   # macOS/Linux
   curl -fsSl https://downloads.ortussolutions.com/debs/gpg | sudo apt-key add -
   or
     brew install commandbox
   
   # Windows
   choco install commandbox

2. Install Wheels CLI:

   box install wheels-cli

3. Create Your First App:

   wheels new myapp
   cd myapp
   box server start

4. Explore Commands:

   wheels --help
   wheels generate --help
   wheels dbmigrate --help

Version Compatibility

Wheels CLI	Wheels	CommandBox	CFML Engine
3.0.x	2.5+	5.0+	Lucee 5.3+, Adobe 2018+
2.0.x	2.0-2.4	4.0+	Lucee 5.2+, Adobe 2016+

Community & Support

• Documentation: https://docs.wheels.dev
• GitHub: https://github.com/wheels-dev/wheels
• Slack: CFML Slack - #wheels channel
• Forums: https://groups.google.com/forum/#!forum/wheels

Contributing

We welcome contributions! See our Contributing Guide for details on:

• Reporting issues

• Suggesting features

• Submitting pull requests

• Creating custom commands

Recent Updates

Version 3.0.0

• 🆕 Modernized service architecture

• 🆕 Enhanced testing capabilities with watch mode

• 🆕 Security scanning and performance optimization

• 🆕 Plugin and environment management

• 🆕 Improved code generation with more options

• 🔧 Better error handling and user feedback

• 📚 Comprehensive documentation

Quick Links

• All Commands - Complete command reference
• Quick Start - Get started in minutes
• Creating Commands - Extend the CLI
• Service Architecture - Technical deep dive
• Testing Guide - Testing best practices

License

Wheels CLI is open source software licensed under the Apache License 2.0. See LICENSE for details.

---

Ready to get started? Head to the Quick Start Guide or explore the Command Reference.