Skip to content

aim_cli ​

Development tools for the Aim ecosystem.

Features ​

  • Project Scaffolding - Create new projects with aim create
  • Development Server - Hot reload with aim dev
  • Production Build - Compile to native executable with aim build
  • Environment Configuration - Manage env variables via pubspec.yaml
  • Edge Targets - aim.target: workers builds for Cloudflare workerd with aim_workers; aim.target: supabase builds for Supabase Edge Functions with aim_deno. Both compile to WebAssembly with aim build. See Configuration.

Quick Start ​

Installation ​

bash
dart install aim_cli

Create a Project ​

bash
aim create my_app
cd my_app

Start Development Server ​

bash
aim dev

Output:

🚀 Starting development server...
📁 Watching: lib, bin
🔥 Hot reload enabled

Server running on http://localhost:8080

Build for Production ​

bash
aim build

Output:

🔨 Compiling for production...
📁 Entry point: bin/server.dart
📦 Output: build/server

✅ Build successful!

Commands ​

CommandDescription
aim create <name>Create a new project
aim devStart dev server with hot reload
aim buildCompile for production
aim db:generateGenerate a migration from schema changes
aim db:migrateApply pending migrations
aim db:rollbackRoll back applied migrations
aim db:statusShow migration status
aim db:resetDrop, recreate, and replay all migrations

See Commands for options and examples, and Migrations for the db:* workflow.

Configuration ​

Configure via pubspec.yaml:

yaml
name: my_app

dependencies:
  aim_server: ^0.4.0

aim:
  entry: bin/server.dart
  env:
    PORT: "8080"
    DATABASE_URL: ${DATABASE_URL}

Next Steps ​

Released under the MIT License.