robius-app-architecture

Robius App Architecture Skill

Best practices for structuring Makepad applications based on the Robrix and Moly codebases - production applications built with Makepad and Robius framework.

Source codebases:

• Robrix: Matrix chat client - complex sync/async with background subscriptions
• Moly: AI chat application - cross-platform (native + WASM) with streaming APIs

When to Use

Use this skill when:

• Building a Makepad application with async backend integration
• Designing sync/async communication patterns in Makepad
• Structuring a Robius-style application
• Keywords: robrix, robius, makepad app structure, async makepad, tokio makepad

Production Patterns

For production-ready async patterns, see the _base/ directory:

Pattern	Description
08-async-loading	Async data loading with loading states
09-streaming-results	Incremental results with SignalToUI
13-tokio-integration	Full tokio runtime integration

Core Architecture Pattern

┌─────────────────────────────────────────────────────────────┐
│                     UI Thread (Makepad)                     │
│  ┌─────────┐     ┌──────────┐     ┌──────────────────────┐ │
│  │   App   │────▶│ WidgetRef │────▶│ Widget Tree (View)  │ │
│  │ State   │     │    ui     │     │ Scope::with_data()  │ │
│  └────┬────┘     └──────────┘     └──────────────────────