Orbit

Orbit is a high-performance Shared Presence Platform designed to foster deep emotional resonance between users. By merging high-fidelity synchronous interaction with thoughtful asynchronous keepsakes, Orbit creates a "physical" digital space where partners can feel truly present, regardless of distance.

---

🌌 Platform Overview

Orbit is built on four architectural pillars that ensure a premium, zero-latency experience:

• Synchronous Presence: Real-time interaction through the Live Canvas, powered by a custom "Bake & Delta" rasterization engine.
• Asynchronous Keepsakes: Long-form communication via Letters and Memories, using physical-world metaphors like vintage paper and polaroid stacks.
• Shared Journey: Growth tracking through Milestones, providing a visual history of shared goals and achievements.
• Native-First Core: A massive Android/Kotlin backend that handles performance-critical tasks (Sync, Security, Media) to keep the Flutter UI thread cold and responsive.

---

🏗️ System Architecture

graph TD
    subgraph "Flutter Frontend (Dart)"
        UI[User Interface]
        VM[Canvas/Zen ViewModels]
        NM[Nav Manager]
    end

    subgraph "Native Core (Kotlin)"
        NS[NativeSyncModule]
        PV[Platform Views]
        IC[IdentityCoordinator]
        HB[Horizon Brain]
    end

    subgraph "External Ecosystem"
        SW[Orbit Sync Worker]
        WS[WebSocket Stream]
    end

    UI --> VM
    VM <-->|EventChannel| NS
    NS <--> WS
    WS <--> SW
    PV <--> UI
    IC <--> NS

Loading

---

🎨 Core Features

1. Live Canvas (Synchronous)

A high-performance shared drawing space.

• Bake & Delta Engine: Active strokes are rendered on a high-frequency isolated layer, while completed strokes are "baked" into a GPU-cached bitmap to ensure constant 120fps.
• High-Res/Low-Res Hybrid: Draws and bakes at 3x DPI for razor-sharp vector-quality strokes, but persists and broadcasts at 1x DPI to maintain zero-latency sync and thermal stability.
• Hardware Nav Parity: Integrated with PopScope and OrbitNavManager to ensure perfect physical back-button behavior across all hardware tiers.
• Binary Delta Sync: Uses raw Float32List binary packets for zero-copy transmission.

2. Zen Mode (Presence)

A specialized, distraction-free space for shared focus. Designed to create a sense of "being in the same room" through subtle environmental cues and presence indicators.

3. Letters & Memories (Asynchronous)

Asynchronous communication tools for when partners are in different time zones.

• Vintage Letters: Hand-written feel with custom native font rendering.
• Memories: High-performance media viewing using native ExoPlayerPool and ParallaxEngine.

4. Shared Milestones

An interactive roadmap for shared life goals, featuring a custom creation suite and progress visualization.

---

🛠️ Native Architecture (Android / Kotlin)

Orbit offloads the heavy lifting to a sophisticated native layer to ensure thermal stability and high performance:

• Platform Views: Premium UI components like OrbitVisionFeedView, NativeUnifiedDock, and OrbitNativeMediaViewer are implemented natively for gesture-perfect interaction.
• Identity & Security: Hardware-backed encryption via Vault.kt and a complex IdentityCoordinator state machine.
• Horizon Intelligence: Native-level signal processing (HorizonBrain.kt) for predictive synchronization and resource management.
• Haptic Engine: Deep integration with system vibrators to provide distinct tactile signatures for different interaction types.
• Resource Governor: Monitors hardware tiers and thermal status to dynamically scale rendering quality (Anti-aliasing, coordinate frequency).

---

⚡ Performance Guardrails

To maintain a premium experience across all devices, Orbit implements strict performance boundaries:

• Thermal Panic Mode: Automatically triggered by IdentityService. Throttles WebSocket broadcast frequency and disables Anti-Aliasing on the Canvas to keep the device cool.
• Hardware Tiering: HardwareTierDetector.kt categorizes devices upon launch. Low-end devices receive optimized 60fps assets and simplified blur shaders.
• Cold-UI Guarantee: By leveraging RepaintBoundary and Native Platform Views, Orbit ensures that the Flutter main thread is never blocked by heavy rendering or network I/O.

---

📡 The Orbit Ecosystem

Orbit is a multi-service system:

1. Flutter Frontend: The primary cross-platform interface.
2. Native Modules: High-performance Kotlin core embedded within the app.
3. Orbit Sync Worker: A TypeScript/Node service (c:\orbit) that orchestrates heavy background data processing and cross-platform logic.

---

📁 Project Structure

Flutter (Dart)

lib/
├── screens/
│   ├── dashboard_screen.dart        # Main hub and navigation
│   ├── canvas_screen.dart           # Live drawing canvas
│   ├── zen_screen.dart              # Shared focus space
│   ├── letters_screen.dart          # Long-form messaging
│   └── milestones_screen.dart       # Shared journey visualization
├── services/
│   ├── identity_service.dart        # Session and thermal monitoring
│   ├── realtime_service.dart        # WebSocket orchestration
│   ├── haptic_service.dart          # Haptic feedback engine
│   └── database_service.dart        # Local persistence
└── widgets/
    ├── polaroid_stack.dart          # Physical media visualization
    ├── vintage_paper.dart           # Paper-texture UI components
    └── unified_dock.dart            # Native-bridged navigation dock

Native (Kotlin)

android/app/src/main/kotlin/app/orbit/ar/
├── MainActivity.kt                  # Channel orchestration
├── IdentityCoordinator.kt           # Session state machine
├── sync/
│   ├── NativeSyncModule.kt          # Binary stream multiplexer
│   └── OrbitRealtimeClient.kt       # WebSocket implementation
├── media/
│   ├── ExoPlayerPool.kt             # Video performance engine
│   └── OrbitVisionFeedView.kt       # Native feed component
├── security/
│   └── Vault.kt                     # Hardware encryption
└── intelligence/
    └── HorizonBrain.kt              # Signal processing

---

---

🚀 Roadmap & Future Plans

Orbit is an evolving ecosystem. The following features are prioritized for upcoming release cycles:

1. Daily Prompts (The "Ask" Engine): A daily connection-building module that drops a single, high-impact question to both partners. Answers are locked until both participants respond, fostering curiosity and deep conversation.
2. Home Screen Widgets (Live Surface): Bringing Orbit presence to the OS home screen via Live Polaroid widgets and real-time status indicators, reducing the friction of staying connected.
3. Ambient Presence (Vibes): A subtle, non-intrusive way to share current activity or mood (e.g., "Drinking Coffee", "Studying", "Listening to [Song]") without sending full notifications.
4. Creative Co-op Games: Expanding the Live Canvas with collaborative drawing puzzles and partnership-focused memory quizzes.

---

🚀 Setup & Development

Prerequisites

• Flutter SDK ^3.x.x
• Android Studio / VS Code
• A device/emulator for testing

Getting Started

1. flutter pub get
2. Ensure the Sync Worker is running in the background.
3. flutter run