Aircada Dev-Planner System
The architectural planning, specification, and authoring framework for building production 3D configurators and spatial web applications in Aircada.
Published: 7/10/2026
The Aircada Dev-Planner serves as the single source of truth for planning, scoping, and architecting interactive 3D configurators before code generation or 3D asset binding begins.
By establishing declarative specifications for user steps, camera presets, tabular datasets (.airpds), pricing models (.airpm), reactive store properties, and SDK class architectures, the Dev-Planner bridges client requirements directly into executable Aircada blueprints.
The architecture is completely decoupled: product UX models dictate user interactions, while the underlying Aircada Engine and @aircada/react SDK handle reactive two-way synchronization and 3D scene mutations.
- Single Source of Truth: All project metadata, datasets, steps, store bindings, and SDK architecture plans reside in a unified specification.
- Decoupled Multi-File Manifest: Relational separation of tabular datasets (.airpds) and option pricing models (.airpm) from the interface flow.
- SDK Architecture Mapping: Maps high-level product customizer requirements directly to @System singleton managers, @Operator scene mutators, and React UI components.
- Multi-Blueprint Foundation: Directly attaches reusable Aircada Library blueprints as starting foundations with contextual modification notes.
Architectural Mental Models for 3D Spatial Applications
→
Foundational mental models for state orchestration, the Unidirectional 3D Triad, declarative-imperative separation, and subsystem boundaries.
Canonical Project Setup & Workspace Scaffolding
→
Standardized directory anatomy, relational data porting (.airpds & .airpm), local SDK symlinking, and dual-pass compilation.
3D Scene Composition & Mesh Slot Abstractions
→
Standardized mesh slot naming conventions (slot*mesh), runtime material swap pipelines, and decoupled 3D asset hierarchy bindings.
Blueprint Lifecycle, Testing Standards & Reverse-Syncing
→
Multi-blueprint workspace decomposition, singular test harness manifests (.airbpt), dev log telemetry assertions, and air bp sync reverse-syncing.
Sequential User Journey Steps & UI Panels
→
Divide complex 3D product customization into intuitive sequential phases, mapping spatial UI controls to interactive 3D scene targets.
3D Camera Choreography & Viewport Staging
→
Principles for staging orbital camera perspectives, FOV parameters, target focus anchors, and smooth phase transitions between customization steps.
Spatial UI Layout Archetypes & Responsive Docking
→
Architecting glassmorphic UI overlay containers, safe viewport boundaries, and responsive desktop-to-mobile docking adaptations.
Spatial UI Aesthetics, Palettes & Typography
→
Formulating curated luxury dark themes, typography hierarchy, contrast ratios, and Euclidean color distance swatch filtering.
Tabular Option Matrices & Datasets (.airpds)
→
Architecting tabular option matrices, relational dataset IDs, column data types, and multi-component choice catalogs.
Commercial Pricing Formulas & Multi-Variant Rules (.airpm)
→
Configuring base pricing, surcharge offsets, conditional option exclusivity rules, and stripped .airpm format compliance.
Reactive Store Blueprint & 3D Scene Synchronization
→
Designing unified reactive store properties (store.properties), state categories, and bidirectional synchronization with 3D shaders and meshes.
Custom Event Bus Signals & Telemetry Triggers
→
Decoupled event-driven messaging, naming conventions for domain events, payload schemas, and telemetry instrumentation.
Multimodal Asset Ingestion, Brand Tokens & 3D Mockups
→
Autonomous browser scraping, computed CSS brand extraction, visual reference galleries, and synthesized 16:9 3D layout mockups.
SDK Code Architecture: @System, @Operator & Blueprint Foundations
→
Architectural decision matrix for @System singleton managers, @Operator scene mutators, React UI components, and contextual blueprint foundations.