adonisjs-cli

# AdonisJS Ace CLI Guide

AdonisJS is a TypeScript-first Node.js framework for building server-side applications. Ace is the command-line framework embedded into AdonisJS core. This guide provides essential workflows and quick references for common AdonisJS operations.

## Quick Start

```bash
# Create new AdonisJS project
npm init adonisjs@latest my-app

# Navigate to project
cd my-app

# Generate app key
node ace generate:key

# Start development server
node ace serve --hmr

# List all available commands
node ace list

# Get help for a command
node ace serve --help
```

## Common Workflows

### Workflow 1: API Project Setup

```bash
# Create API project
npm init adonisjs@latest my-api -- --kit=api

cd my-api

# Generate app key
node ace generate:key

# Install and configure database
node ace add @adonisjs/lucid

# Create initial model with migration
node ace make:model User -m

# Run migrations
node ace migration:run

# Start dev server with HMR
node ace serve --hmr
```

### Workflow 2: CRUD Resource Creation

```bash
# Create complete resource (model, migration, factory, controller)
node ace make:model Post -mfc

# Create validators for the resource
node ace make:validator post --resource

# Create service for business logic
node ace make:service post

# Edit migration file (database/migrations/xxxxx_posts.ts)
# Add table columns

# Run migration
node ace migration:run

# Create seeder for testing data
node ace make:seeder Post

# Run seeder
node ace db:seed
```

### Workflow 3: Database Management

```bash
# Create migration
node ace make:migration add_slug_to_posts

# Preview migration changes (dry run)
node ace migration:run --dry-run

# Run migrations
node ace migration:run

# Check migration status
node ace migration:status

# Rollback last batch
node ace migration:rollback

# Refresh database (reset + run)
node ace migration:refresh --seed
```

### Workflow 4: Authentication Setup

```bash
# Install authentication package
node ace add @adonisjs/auth

# Inst