NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
The official CLI for the Air Framework. Streamline your Flutter development with modular architecture, automated code generation, and scalable state management.
Last release 6 months ago
11 Apr 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 11 of 12 stable releases
Nothing withdrawn
no release was ever pulled
8 months old
12 releases · first in 2026
One column per month.
Skill Documentation: Updated all air_framework skill references and examples to use the new AirPulse callable shorthand syntax (e.g., CounterPulses.in
air_framework skill references and examples to use the new AirPulse callable shorthand syntax (e.g., CounterPulses.increment(null) instead of CounterPulses.increment.pulse(null)).Skill Enhancement: Updated the air_framework AI agent skill (SKILL.md) to include documentation and examples for the new AirListener widget. This teac
air_framework AI agent skill (SKILL.md) to include documentation and examples for the new AirListener widget. This teaches AI agents to correctly separate one-off side effects from UI building.`air skills install`: Fixed asset resolution when running as a globally installed package using Isolate.resolvePackageUri.
air skills install: Fixed asset resolution when running as a globally installed package using Isolate.resolvePackageUri.air version: Robust version detection in production environments using the new AssetResolver logic.Nothing published for this version
`air create community-module `: New command to scaffold a standalone module ready to publish and share with the community. Generates module.yaml (Air
air create community-module <name>: New command to scaffold a standalone module ready to publish and share with the community. Generates module.yaml (Air manifest), pubspec.yaml, README.md, full lib/ structure (module, state, service, screen, barrel export), and .gitignore. Supports --author=<github_username>.air module add now asks before overwriting: Previously silently deleted and replaced an existing module. Now prompts with y/N (default: No) before overwriting, preventing accidental loss of local customizations.air module add shows registration hint: After a successful install, reads module_class from the module's module.yaml and prints the exact ModuleManager().register([...]) snippet the user needs to add to main.dart.Visual Identity: Added the official Air Framework SVG logo to the README.
Adapter System: Added air generate adapter command to scaffold headless service integrations with the recommended structure (contracts, implementation
air generate adapter <name> command to scaffold headless service integrations with the recommended structure (contracts, implementation, adapter).references/adapters.md with full adapter reference (lifecycle, boot order, contract rule, naming conventions, DevTools).SKILL.md with adapter keywords, quick-start, key rules (adapters before modules, contract rule), and updated file structure.references/cli.md.Air Adapters: Introduced AirAdapter base class and AdapterManager for headless service integrations (HTTP, analytics, error tracking, etc.).
AirAdapter base class and AdapterManager for headless service integrations (HTTP, analytics, error tracking, etc.).core.dart and framework.dart barrel exports for adapters.AI Agent Selection: Added interactive selection and "all" option to air skills install. Supports Antigravity, Claude Code, OpenCode, and Cursor.
air skills install. Supports Antigravity, Claude Code, OpenCode, and Cursor.air create: Added support for air create . to initialize projects in the current directory. Includes automatic snake_case project name derivation and sanitization.air skills install — copies the Air Framework agent skill into .agent/skills/air_framework/ and registers it in AGENTS.md so AI agents automatically know where the skill is and what it does.module add command now prefers module.yaml for dependency synchronization. This allows modules to define their dependencies without needing a full pubspec.yaml.inject<T>() over AirDI().get<T>() in state classes.air create command now fetches the latest available versions of air_framework, air_generator, and go_router from pub.dev.pubspec.yaml.Generator Overhaul: Replaced the legacy 3-file state generation with a unified @GenerateState pattern.
@GenerateState pattern.extends AppModule and the latest AirView patterns.Reactive State Generation: Added support for @GenerateState annotation with the --generator flag.
@GenerateState annotation with the --generator flag.AppModule interface: onBind() -> onBind(AirDI di) and initialize() -> onInit(AirDI di).air_framework changes.Initial release of the Air CLI.
air create.air gen module.Your coding agent can read these notes before it upgrades. Set up the MCP server →