Air Framework

Why Air Framework?

Your app starts clean. Then the team grows, features multiply, and suddenly every change breaks something else. State leaks between screens. Three developers edited the same file last week. Onboarding a new engineer takes days just to understand where things live.

Air Framework solves this by treating each feature as a fully isolated module — with its own lifecycle, DI scope, routes, and reactive state — orchestrated by a lightweight core that enforces strict boundaries and explicit dependencies.

The Power of Being Modular

• Team Autonomy: Empower multiple teams to create and maintain features independently. New teams can jump into specific modules without needing to understand the entire monolithic codebase.
• Logic Decoupling: Separate your business logic from the main application. Build modules as standalone units and integrate them into the app whenever they are ready.
• Git-Ready Architecture: Cleanly split your code into separate Git repositories. This allows for better versioning, access control, and a more manageable development workflow.

Team-Centric Modularity

Build and maintain modules in isolation. Each feature is a self-contained unit — perfect for multi-team environments and independent Git repositories.

Reactive State

Powered by air_state with @GenerateState code generation. Zero boilerplate, fine-grained rebuilds, and a clean Pulse → State → Flow → UI data flow.

Adapters

Headless service integrations (HTTP, analytics, error tracking) behind abstract contracts. Swap implementations without touching a single module.

Dependency Injection

Type-safe, scoped DI with explicit module ownership and full lifecycle management via onBind and onInit.

Secure by Design

Opt-in permission system, secure service registry with caller restrictions, and TTL-based shared data for enterprise needs.

AI Agent Skills

Run air skills install to give your AI coding agent instant framework knowledge — correct modules and state generated on the first prompt.

Core Packages

Package	Description
air_framework	The core orchestrator for modules, DI, routing, and security.
air_state	Lightweight reactive state management core.
air_generator	Build runner code generation for reactive states.
air_cli	Official command-line tool for scaffolding and automation.