aim_cli
Command-line tools for the Aim framework with project scaffolding, development server, and hot reload support.
0.1.1
aim-dart/aim
What this package is like to depend on
Last release 7 months ago
20 Jan 2026
Too new to tell
only 2 release windows
Nearly every release is documented
notes for 4 of 4 stable releases
Nothing withdrawn
no release was ever pulled
8 months old
4 releases · first in 2025
4 releases in the last 12 months
see the full history below
Release timeline
4 releases · Dec 2025 to Jan 2026Releases
latest 4-
0.1.120 Jan 2026 -
0.1.020 Jan 2026Release notes
Open source →Changelog
0.1.0
First beta release of Aim Framework - a modular ecosystem for Dart.
Highlights
- Lightweight, fast web server framework
- Native PostgreSQL driver (no external dependencies)
- Type-safe ORM with Record syntax
- CLI tools with hot reload and database migrations
Web Server (aim_server)
- HTTP server built on Dart's native
HttpServer - Path-based routing with parameter support (
/users/:id) - Composable middleware chain
- JSON, text, HTML response handling
- Real-time SSE streaming support
- Custom error handlers (404, global)
Middleware Packages
- aim_server_cors: CORS configuration
- aim_server_cookie: Secure cookie management
- aim_server_form: Form data parsing
- aim_server_multipart: File upload handling
- aim_server_static: Static file serving
- aim_server_logger: HTTP request logging
- aim_server_sse: Server-Sent Events
- aim_server_jwt: JWT authentication
- aim_server_basic_auth: Basic authentication
Testing (aim_server_testing)
- Test helpers and matchers
- Mock objects for unit testing
- Integration test utilities
Database (aim_database + aim_postgres)
- Database abstraction layer
- Native PostgreSQL Wire Protocol implementation
- SSL/TLS support (disable, allow, prefer, require, verify-ca, verify-full)
- Authentication: cleartext, MD5, SCRAM-SHA-256
- Named parameters (
:name) and positional parameters ($1) - Transaction support with automatic commit/rollback
ORM (aim_orm + aim_orm_postgres + aim_orm_codegen)
- Type-safe table definitions using Dart Record syntax
- Column types:
integer,bigint,varchar,text,boolean,timestamp,uuid,json - Column modifiers:
primaryKey,unique,nullable,withDefault,indexed - Query builders: SELECT, INSERT, UPDATE, DELETE
- Condition operators:
eq,gt,lt,gte,lte,inList - Code generation with
build_runner
CLI (aim_cli)
aim create <name>: Project scaffoldingaim dev: Development server with hot reloadaim build: Production build with native compilationaim db:generate: Migration SQL generation from schema diffaim db:migrate: Apply pending migrationsaim db:rollback: Rollback migrationsaim db:status: Show migration status
Known Limitations
- ORM Relations (1:1, 1:N, N:N) not yet supported
- SQLite driver not yet available
db:resetcommand not yet implemented
Requirements
- Dart SDK:
^3.10.0 - PostgreSQL: 9.5+ (SCRAM-SHA-256 requires 10+)
Release notes
Open source →First beta release of Aim Framework - a modular ecosystem for Dart.
Highlights
- Lightweight, fast web server framework
- Native PostgreSQL driver (no external dependencies)
- Type-safe ORM with Record syntax
- CLI tools with hot reload and database migrations
Web Server (aim_server)
- HTTP server built on Dart's native
HttpServer - Path-based routing with parameter support (
/users/:id) - Composable middleware chain
- JSON, text, HTML response handling
- Real-time SSE streaming support
- Custom error handlers (404, global)
Middleware Packages
- aim_server_cors: CORS configuration
- aim_server_cookie: Secure cookie management
- aim_server_form: Form data parsing
- aim_server_multipart: File upload handling
- aim_server_static: Static file serving
- aim_server_logger: HTTP request logging
- aim_server_sse: Server-Sent Events
- aim_server_jwt: JWT authentication
- aim_server_basic_auth: Basic authentication
Testing (aim_server_testing)
- Test helpers and matchers
- Mock objects for unit testing
- Integration test utilities
Database (aim_database + aim_postgres)
- Database abstraction layer
- Native PostgreSQL Wire Protocol implementation
- SSL/TLS support (disable, allow, prefer, require, verify-ca, verify-full)
- Authentication: cleartext, MD5, SCRAM-SHA-256
- Named parameters (
:name) and positional parameters ($1) - Transaction support with automatic commit/rollback
ORM (aim_orm + aim_orm_postgres + aim_orm_codegen)
- Type-safe table definitions using Dart Record syntax
- Column types:
integer,bigint,varchar,text,boolean,timestamp,uuid,json - Column modifiers:
primaryKey,unique,nullable,withDefault,indexed - Query builders: SELECT, INSERT, UPDATE, DELETE
- Condition operators:
eq,gt,lt,gte,lte,inList - Code generation with
build_runner
CLI (aim_cli)
aim create <name>: Project scaffoldingaim dev: Development server with hot reloadaim build: Production build with native compilationaim db:generate: Migration SQL generation from schema diffaim db:migrate: Apply pending migrationsaim db:rollback: Rollback migrationsaim db:status: Show migration status
Known Limitations
- ORM Relations (1:1, 1:N, N:N) not yet supported
- SQLite driver not yet available
db:resetcommand not yet implemented
Requirements
- Dart SDK:
^3.10.0 - PostgreSQL: 9.5+ (SCRAM-SHA-256 requires 10+)
-
0.0.225 Dec 2025Release notes
Open source →Production build and Docker support.
Features
- Production Build:
aim buildcommand to compile server for production deployment- Native executable compilation using
dart compile exe - Automatic entry point detection from
pubspec.yaml - Configurable output path with
--outputoption - Default output:
build/server
- Docker Support:
- Dockerfile template with multi-stage build
- Optimized for minimal image size using
scratchbase .dockerignoretemplate to exclude unnecessary files- Production-ready Docker configuration
- Enhanced Project Templates:
- Updated README with production deployment instructions
- Environment variable usage examples for native and Docker deployments
- Security best practices for environment variable handling
- Simplified
pubspec.yamlwithaim_server: ^0.0.6
Commands
aim build [options]- Compile server for production deployment-e, --entry- Specify server entry point-o, --output- Specify output file path
Security
- Environment variables are not embedded at compile time
- Runtime environment variable support for secure configuration management
- Compatible with Docker secrets and Kubernetes ConfigMaps
- Production Build:
-
0.0.124 Dec 2025Release notes
Open source →Initial release of aim_cli - Command-line tools for the Aim web framework.
Features
- Project Scaffolding:
aim createcommand to generate new Aim projects- Pre-configured project structure with best practices
- Automatic generation of example routes and middleware
- Development Server:
aim devcommand to start development server- Hot reload support with automatic server restart on file changes
- Configurable entry point
- Environment variable support from
pubspec.yaml
- File Watching:
- Monitors
.dartfiles andpubspec.yamlfor changes - Debounced file watching (500ms) to avoid excessive restarts
- Configurable watch directories
- Monitors
- Process Management:
- Graceful shutdown with SIGTERM
- Force kill fallback with SIGKILL
- Clean process lifecycle management
- Project Validation:
- Project name validation (lowercase, alphanumeric, underscores)
- Reserved word checking
- Directory existence validation
Supported
- Dart SDK:
^3.10.0 - Platforms: All platforms supported by Dart (Linux, macOS, Windows)
- Installation:
dart install aim_cli(Dart 3.10+)
Commands
aim create <project_name>- Create a new Aim projectaim dev [options]- Start development server with hot reload
What's Included
- Project templates for quick start
- Hot reload infrastructure
- File watching utilities
- Environment variable expansion
- Process management utilities
- Project Scaffolding: