# poppingmoon/aria architecture

> Architecture diagram of the GitHub repository poppingmoon/aria, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/poppingmoon/aria
- Repository: https://github.com/poppingmoon/aria

## Overview

##### Project type and purpose
- Aria is a cross-platform client application for the Misskey social network.
- Built with Flutter (Dart) for UI on Android, iOS, macOS, Linux, Windows, and the Web.
- Embeds a Rust core (via flutter_rust_bridge) for performance-sensitive tasks (e.g., AIscript processing).
- Uses Riverpod for state management, REST and WebSocket to communicate with Misskey servers, plus local caching and persistence (shared_preferences, file system).

##### High-level file-structure analysis
- Top-level “android”, “ios”, “linux”, “macos”, “windows”, “web”: platform embedding and native shell.
- “lib”: Dart source, subdivided into:
- main.dart + router/ – entry point and navigation layer
- view/ – UI widgets and pages
- model/ – data structures (Freezed, JSON-serializable)
- provider/ – Riverpod providers and state notifiers
- repository/ – abstracted data sources (Token, Auth, Summaly, Window settings)
- util/ – helper functions
- rust/ – glue code for calling Rust via flutter_rust_bridge
- “rust”: pure Rust library exposing APIs (AIscript, init) and generating FFI stubs.
- “rust_builder”: scripts and plug-ins to compile the Rust library for each platform.
- CI and release scripts (fastlane, GitHub workflows, snapcraft).

##### Key architectural insights from README and code
- Flutter’s “engine + Dart” hosts UI and business logic.
- Riverpod providers isolate stateful logic and coordinate API calls.
- Repositories encapsulate network/storage; providers or hooks consume them.
- rust core performs compute-heavy or platform-specific tasks, called via FFI.
- Network layer: Dio HTTP client + WebSocket channels for streaming events.
- Local persistence: SharedPreferences and file system for caching, plus window sizing/position storage.

## Diagram (Mermaid)

```mermaid
graph TD
    subgraph "Platform Shells"
        Android["Android"]:::platform
        iOS["iOS"]:::platform
        Linux["Linux"]:::platform
        macOS["macOS"]:::platform
        Windows["Windows"]:::platform
        Web["Web"]:::platform
    end

    FlutterEngine["Flutter Engine & Dart Runtime"]:::engine

    subgraph "Assets & Localization"
        AssetsDir["assets/"]:::assets
        AssetsGen["lib/gen/assets.gen.dart"]:::assets
        I18n["lib/i18n/"]:::assets
    end

    subgraph "Dart Layers"
        subgraph "Entry & Navigation"
            Main["main.dart"]:::dart
            Router["router (router.dart, router.g.dart)"]:::dart
        end
        subgraph "UI Layer"
            View["view/"]:::dart
        end
        subgraph "State Management"
            Provider["provider/"]:::dart
            APIState["api/, streaming/"]:::dart
            SharedPref["shared_preferences_provider.dart"]:::dart
            FileSys["file_system_provider.dart"]:::dart
        end
        subgraph "Repositories"
            AuthRepo["miauth_repository.dart"]:::dart
            SummaryRepo["summaly_repository.dart"]:::dart
            TokenRepo["token_repository.dart"]:::dart
            WinPosRepo["window_position_repository.dart"]:::dart
            WinSizeRepo["window_size_repository.dart"]:::dart
        end
        subgraph "Models"
            Model["model/"]:::dart
        end
        subgraph "Utilities"
            Util["util/"]:::dart
        end
        subgraph "Rust FFI Bridge"
            FRBGen["frb_generated.dart/io/web.dart"]:::rustffi
            FRBApi["lib/rust/api/"]:::rustffi
            Config["flutter_rust_bridge.yaml"]:::rustffi
        end
    end

    subgraph "Rust Core"
        RustLib["rust/src/lib.rs"]:::rust
        AIscriptRS["rust/src/api/aiscript.rs"]:::rust
        AIScriptMod["rust/src/api/aiscript/"]:::rust
        InitRS["rust/src/api/init.rs"]:::rust
        FRBNative["rust/src/frb_generated.rs"]:::rustffi
    end

    subgraph "Build & CI/CD"
        RustBuilder["rust_builder/"]:::build
        CI1[".github/workflows/build.yml"]:::build
        CI2[".github/workflows/ci.yml"]:::build
        Fastlane["fastlane/"]:::build
        Snap["snapcraft.yaml"]:::build
    end

    subgraph "External Services"
        MisskeyREST["Misskey REST API"]:::external
        MisskeyWS["Misskey WebSocket"]:::external
        Push["APNs/Firebase/Unified Push"]:::external
    end

    Android --> FlutterEngine
    iOS --> FlutterEngine
    Linux --> FlutterEngine
    macOS --> FlutterEngine
    Windows --> FlutterEngine
    Web --> FlutterEngine

    AssetsDir --> FlutterEngine
    AssetsGen --> FlutterEngine
    I18n --> FlutterEngine

    FlutterEngine --> Main
    Main --> Router
    Router --> View

    View --> Provider
    Provider --> APIState
    Provider --> AuthRepo
    Provider --> SummaryRepo
    Provider --> TokenRepo
    Provider --> WinPosRepo
    Provider --> WinSizeRepo
    Provider --> SharedPref
    Provider --> FileSys
    Provider --> Util

    APIState --> MisskeyREST
    APIState --> MisskeyWS

    AuthRepo --> MisskeyREST
    SummaryRepo --> MisskeyREST
    TokenRepo --> MisskeyREST
    WinPosRepo --> SharedPref
    WinSizeRepo --> SharedPref

    AuthRepo --> Model
    SummaryRepo --> Model
    TokenRepo --> Model

    SharedPref --> Model
    FileSys --> Model

    View --> FRBGen
    Provider --> FRBGen
    FRBGen --> RustLib
    RustLib --> FRBNative
    FRBApi --> FRBGen
    RustBuilder --> RustLib
    CI1 --> RustBuilder
    CI2 --> RustBuilder
    Fastlane --> FlutterEngine
    Snap --> FlutterEngine

    classDef platform fill:#E8EAF6,stroke:#3F51B5
    classDef engine fill:#E1F5FE,stroke:#0288D1
    classDef dart fill:#E8F5E9,stroke:#388E3C
    classDef rustffi fill:#FFF3E0,stroke:#FB8C00
    classDef rust fill:#F3E5F5,stroke:#8E24AA
    classDef build fill:#ECEFF1,stroke:#607D8B
    classDef external fill:#FFEBEE,stroke:#E53935
    classDef assets fill:#FFFDE7,stroke:#FDD835

    click Android "https://github.com/poppingmoon/aria/tree/main/android/"
    click iOS "https://github.com/poppingmoon/aria/tree/main/ios/"
    click Linux "https://github.com/poppingmoon/aria/tree/main/linux/"
    click macOS "https://github.com/poppingmoon/aria/tree/main/macos/"
    click Windows "https://github.com/poppingmoon/aria/tree/main/windows/"
    click Web "https://github.com/poppingmoon/aria/tree/main/web/"
    click Main "https://github.com/poppingmoon/aria/blob/main/lib/main.dart"
    click Router "https://github.com/poppingmoon/aria/blob/main/lib/router/router.dart"
    click Router "https://github.com/poppingmoon/aria/blob/main/lib/router/router.g.dart"
    click View "https://github.com/poppingmoon/aria/tree/main/lib/view/"
    click Provider "https://github.com/poppingmoon/aria/tree/main/lib/provider/"
    click APIState "https://github.com/poppingmoon/aria/tree/main/lib/provider/api/"
    click APIState "https://github.com/poppingmoon/aria/tree/main/lib/provider/streaming/"
    click AuthRepo "https://github.com/poppingmoon/aria/blob/main/lib/repository/miauth_repository.dart"
    click SummaryRepo "https://github.com/poppingmoon/aria/blob/main/lib/repository/summaly_repository.dart"
    click TokenRepo "https://github.com/poppingmoon/aria/blob/main/lib/repository/token_repository.dart"
    click WinPosRepo "https://github.com/poppingmoon/aria/blob/main/lib/repository/window_position_repository.dart"
    click WinSizeRepo "https://github.com/poppingmoon/aria/blob/main/lib/repository/window_size_repository.dart"
    click Model "https://github.com/poppingmoon/aria/tree/main/lib/model/"
    click Util "https://github.com/poppingmoon/aria/tree/main/lib/util/"
    click FRBGen "https://github.com/poppingmoon/aria/blob/main/lib/rust/frb_generated.dart"
    click FRBGen "https://github.com/poppingmoon/aria/blob/main/lib/rust/frb_generated.io.dart"
    click FRBGen "https://github.com/poppingmoon/aria/blob/main/lib/rust/frb_generated.web.dart"
    click FRBApi "https://github.com/poppingmoon/aria/tree/main/lib/rust/api/"
    click Config "https://github.com/poppingmoon/aria/blob/main/flutter_rust_bridge.yaml"
    click FRBNative "https://github.com/poppingmoon/aria/blob/main/rust/src/frb_generated.rs"
    click RustLib "https://github.com/poppingmoon/aria/blob/main/rust/src/lib.rs"
    click AIscriptRS "https://github.com/poppingmoon/aria/blob/main/rust/src/api/aiscript.rs"
    click AIScriptMod "https://github.com/poppingmoon/aria/tree/main/rust/src/api/aiscript/"
    click InitRS "https://github.com/poppingmoon/aria/blob/main/rust/src/api/init.rs"
    click RustBuilder "https://github.com/poppingmoon/aria/tree/main/rust_builder/"
    click AssetsDir "https://github.com/poppingmoon/aria/tree/main/assets/"
    click AssetsGen "https://github.com/poppingmoon/aria/blob/main/lib/gen/assets.gen.dart"
    click I18n "https://github.com/poppingmoon/aria/tree/main/lib/i18n/"
    click SharedPref "https://github.com/poppingmoon/aria/blob/main/lib/provider/shared_preferences_provider.dart"
    click FileSys "https://github.com/poppingmoon/aria/blob/main/lib/provider/file_system_provider.dart"
    click CI1 "https://github.com/poppingmoon/aria/blob/main/.github/workflows/build.yml"
    click CI2 "https://github.com/poppingmoon/aria/blob/main/.github/workflows/ci.yml"
    click Fastlane "https://github.com/poppingmoon/aria/tree/main/fastlane/"
    click Snap "https://github.com/poppingmoon/aria/blob/main/snapcraft.yaml"
```
