Roadmap
1.0 is the next release. It freezes class names, tokens, CSS exports, catalog ids, CLI flags, and MCP tool names until 2.0. The full contract is Compatibility.
Nothing below is a 1.0 gate. Items after 1.0 are additive, so they land in 1.x minors without breaking what you already use. No dates. Items ship when they are ready.
In 1.0
Section titled “In 1.0”One CSS import. Zero runtime. Use it as the design system, or wrap a kit. Use as much as you need.
- Tokens — CSS-first. JSON and TypeScript are generated from that CSS. Tokens.
- Structure — primitives (
af-stack,af-inline,af-grid) and shells (af-app). Structure. - Patterns — accessible HTML/CSS UI with live examples. Patterns.
- Theming — override
--af-*in CSS. Light, dark, high-contrast, anddata-brand. BYO Tokens — product-owned variables viatheme.byoTokens. Theming · BYO Tokens. - Any framework — React, Angular, Vue, HTML. Same classes. Installation.
- AI and editor — AI rules, class reference, Airframe MCP, and IntelliSense for Airframe. Airframe for AI agents · AI Rules.
- Build CLI — optional
@airframeui/build. Custom breakpoints,af theme, and agent bootstrap. Not part of core. - ESLint plugin — leftover Tailwind/Bootstrap classes, unknown
af-*names, redundant defaults.@airframeui/eslint-plugin. - Airframe → Figma — same brand colours in the live app and Figma. Figma Community plugin (
af theme export→ Update Figma) or the Theme Studio / DTCG pack. Figma plugin · Airframe → Figma.
Masonry (af-masonry*) ships as experimental. It sits outside the 1.x promise and may change in a minor. Compatibility.
After 1.0
Section titled “After 1.0”Planned for 1.x, roughly in this order.
- Figma Pattern library and Code Connect — builds on Variables sync, which already ships via the Community plugin and Enterprise REST (
af figma sync/check). - Existing tokens — import a design system and map it to
--af-*.
Could have
Section titled “Could have”Not committed. Do not wait for these.
- Web Components — an optional implementation on the same CSS. Not a replacement for the grammar.
@airframeui/elementsis unpublished. - Migrate CLI — a codemod that rewrites Bootstrap/Tailwind classes to
af-*. Cheat sheets and the ESLint plugin cover the same path today.@airframeui/migrateis unpublished. - DSDS export — optional generated catalog → Design System Doc Spec for interop. Not how we author docs. Parked while the spec is pre-1.0.
Not planned
Section titled “Not planned”Out of scope on purpose.
- Official React, Angular, or Vue runtime packages. Wrap
af-*in your own files. Use as much as you need. - A portable widget kit with the same keyboard map in every engine. That is a behaviour library. Why Airframe.
- A Tailwind preset. Import Airframe CSS and map
--af-*instead of running two grammars.