# ensembleui/ensemble architecture

> Architecture diagram of the GitHub repository ensembleui/ensemble, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ensembleui/ensemble
- Repository: https://github.com/ensembleui/ensemble

## Overview

This checkout is a partial Ensemble monorepo: it includes Starter configuration/host code and selected platform plugins, but not the main Flutter runtime or declarative app renderer described by the README. The visible user-to-result path is configuring module enablement and launching the Starter host; the plugin nodes show selected native capabilities. Several plugin directories are present in the tree but their runtime implementation was not sampled, so their internals and wiring are not inferred.

Main entry points: [`starter/linux/my_application.cc`](https://github.com/ensembleui/ensemble/blob/main/starter/linux/my_application.cc) (Linux Flutter host), [`starter/src/modules_scripts.ts`](https://github.com/ensembleui/ensemble/blob/main/starter/src/modules_scripts.ts) (Module enablement), [`packages/flutter_share_receiver/android/src/main/kotlin/com/kasem/receive_sharing_intent/ReceiveSharingIntentPlugin.kt`](https://github.com/ensembleui/ensemble/blob/main/packages/flutter_share_receiver/android/src/main/kotlin/com/kasem/receive_sharing_intent/ReceiveSharingIntentPlugin.kt) (Android share receiver), [`packages/ensemble_otp/android/src/main/kotlin/com/shivam/otp_pin_field/OtpPinFieldPlugin.kt`](https://github.com/ensembleui/ensemble/blob/main/packages/ensemble_otp/android/src/main/kotlin/com/shivam/otp_pin_field/OtpPinFieldPlugin.kt) (SMS OTP plugin)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_starter["Starter app"]
  node_module_catalog["Module enablement<br/>[modules_scripts.ts]"]
  node_firebase_params["Firebase parameters<br/>[common-params.ts]"]
  node_starter_types["Script types<br/>[interfaces.ts]"]
  node_dart_runner["Dart runner<br/>[dart_runner.ts]"]
  node_starter_host["Linux Flutter host<br/>[my_application.cc]"]
  node_starter_entry["Linux entry point<br/>[main.cc]"]
  node_plugin_registrar["Linux plugin registrar"]
end

subgraph group_media["Media plugins"]
  node_camera_worker["Camera image worker<br/>[image_worker.js]"]
  node_face_api["Face camera API<br/>[face_api.js]"]
  node_face_detection["Face detection<br/>[face_detection.js]"]
  node_share_android["Android share receiver"]
  node_share_files["Shared file handling<br/>[FileDirectory.kt]"]
  node_share_ios["iOS share extension"]
end

subgraph group_platform["Platform plugins"]
  node_sms_otp["SMS OTP plugin"]
  node_app_signature["App signature helper"]
  node_file_manager["File manager module"]
end

subgraph group_integrations["App integrations"]
  node_analytics["Firebase analytics module"]
  node_chat["Chat module"]
end

node_builder(("App builder"))
node_declarative["Declarative apps"]
node_external_share(("Device share intents"))
node_sms_service(("SMS Retriever"))

node_builder -->|"configures"| node_declarative
node_declarative -->|"runs in Starter"| node_starter_host
node_module_catalog -->|"uses parameters"| node_firebase_params
node_module_catalog -->|"uses types"| node_starter_types
node_starter_entry -->|"creates app"| node_starter_host
node_starter_host -->|"registers plugins"| node_plugin_registrar
node_share_android -->|"uses file handling"| node_share_files
node_external_share -.->|"delivers intents"| node_share_android
node_external_share -->|"provides shared media"| node_share_ios
node_sms_otp -->|"gets signature"| node_app_signature
node_sms_service -.->|"delivers SMS"| node_sms_otp

click node_module_catalog "https://github.com/ensembleui/ensemble/blob/main/starter/src/modules_scripts.ts"
click node_firebase_params "https://github.com/ensembleui/ensemble/blob/main/starter/src/common-params.ts"
click node_starter_types "https://github.com/ensembleui/ensemble/blob/main/starter/src/interfaces.ts"
click node_dart_runner "https://github.com/ensembleui/ensemble/blob/main/starter/src/dart_runner.ts"
click node_starter_host "https://github.com/ensembleui/ensemble/blob/main/starter/linux/my_application.cc"
click node_starter_entry "https://github.com/ensembleui/ensemble/blob/main/starter/linux/main.cc"
click node_plugin_registrar "https://github.com/ensembleui/ensemble/blob/main/starter/linux/flutter/generated_plugin_registrant.cc"
click node_camera_worker "https://github.com/ensembleui/ensemble/blob/main/modules/camera/web/image_worker.js"
click node_face_api "https://github.com/ensembleui/ensemble/blob/main/modules/face_camera/web/face_api.js"
click node_face_detection "https://github.com/ensembleui/ensemble/blob/main/modules/face_camera/web/face_detection.js"
click node_share_android "https://github.com/ensembleui/ensemble/blob/main/packages/flutter_share_receiver/android/src/main/kotlin/com/kasem/receive_sharing_intent/ReceiveSharingIntentPlugin.kt"
click node_share_files "https://github.com/ensembleui/ensemble/blob/main/packages/flutter_share_receiver/android/src/main/kotlin/com/kasem/receive_sharing_intent/FileDirectory.kt"
click node_share_ios "https://github.com/ensembleui/ensemble/blob/main/packages/flutter_share_receiver/ios/Classes/RSIShareViewController.swift"
click node_sms_otp "https://github.com/ensembleui/ensemble/blob/main/packages/ensemble_otp/android/src/main/kotlin/com/shivam/otp_pin_field/OtpPinFieldPlugin.kt"
click node_app_signature "https://github.com/ensembleui/ensemble/blob/main/packages/ensemble_otp/android/src/main/kotlin/com/shivam/otp_pin_field/AppSignatureHelper.kt"
click node_file_manager "https://github.com/ensembleui/ensemble/tree/main/modules/file_manager"
click node_analytics "https://github.com/ensembleui/ensemble/tree/main/modules/firebase_analytics"
click node_chat "https://github.com/ensembleui/ensemble/tree/main/modules/chat"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_module_catalog,node_firebase_params,node_starter_types,node_dart_runner,node_starter_host,node_starter_entry,node_plugin_registrar toneBlue
class node_camera_worker,node_face_api,node_face_detection,node_share_android,node_share_files,node_share_ios toneAmber
class node_sms_otp,node_app_signature,node_file_manager toneMint
class node_analytics,node_chat toneRose
class node_builder,node_declarative,node_external_share,node_sms_service toneIndigo
```

## Components

### Starter app

- [Module enablement](https://github.com/ensembleui/ensemble/blob/main/starter/src/modules_scripts.ts): `starter/src/modules_scripts.ts`
- [Firebase parameters](https://github.com/ensembleui/ensemble/blob/main/starter/src/common-params.ts): `starter/src/common-params.ts`
- [Script types](https://github.com/ensembleui/ensemble/blob/main/starter/src/interfaces.ts): `starter/src/interfaces.ts`
- [Dart runner](https://github.com/ensembleui/ensemble/blob/main/starter/src/dart_runner.ts): `starter/src/dart_runner.ts`
- [Linux Flutter host](https://github.com/ensembleui/ensemble/blob/main/starter/linux/my_application.cc): `starter/linux/my_application.cc`
- [Linux entry point](https://github.com/ensembleui/ensemble/blob/main/starter/linux/main.cc): `starter/linux/main.cc`
- [Linux plugin registrar](https://github.com/ensembleui/ensemble/blob/main/starter/linux/flutter/generated_plugin_registrant.cc): `starter/linux/flutter/generated_plugin_registrant.cc`

### Media plugins

- [Camera image worker](https://github.com/ensembleui/ensemble/blob/main/modules/camera/web/image_worker.js): `modules/camera/web/image_worker.js`
- [Face camera API](https://github.com/ensembleui/ensemble/blob/main/modules/face_camera/web/face_api.js): `modules/face_camera/web/face_api.js`
- [Face detection](https://github.com/ensembleui/ensemble/blob/main/modules/face_camera/web/face_detection.js): `modules/face_camera/web/face_detection.js`
- [Android share receiver](https://github.com/ensembleui/ensemble/blob/main/packages/flutter_share_receiver/android/src/main/kotlin/com/kasem/receive_sharing_intent/ReceiveSharingIntentPlugin.kt): `packages/flutter_share_receiver/android/src/main/kotlin/com/kasem/receive_sharing_intent/ReceiveSharingIntentPlugin.kt`
- [Shared file handling](https://github.com/ensembleui/ensemble/blob/main/packages/flutter_share_receiver/android/src/main/kotlin/com/kasem/receive_sharing_intent/FileDirectory.kt): `packages/flutter_share_receiver/android/src/main/kotlin/com/kasem/receive_sharing_intent/FileDirectory.kt`
- [iOS share extension](https://github.com/ensembleui/ensemble/blob/main/packages/flutter_share_receiver/ios/Classes/RSIShareViewController.swift): `packages/flutter_share_receiver/ios/Classes/RSIShareViewController.swift`

### Platform plugins

- [SMS OTP plugin](https://github.com/ensembleui/ensemble/blob/main/packages/ensemble_otp/android/src/main/kotlin/com/shivam/otp_pin_field/OtpPinFieldPlugin.kt): `packages/ensemble_otp/android/src/main/kotlin/com/shivam/otp_pin_field/OtpPinFieldPlugin.kt`
- [App signature helper](https://github.com/ensembleui/ensemble/blob/main/packages/ensemble_otp/android/src/main/kotlin/com/shivam/otp_pin_field/AppSignatureHelper.kt): `packages/ensemble_otp/android/src/main/kotlin/com/shivam/otp_pin_field/AppSignatureHelper.kt`
- [File manager module](https://github.com/ensembleui/ensemble/tree/main/modules/file_manager): `modules/file_manager`

### App integrations

- [Firebase analytics module](https://github.com/ensembleui/ensemble/tree/main/modules/firebase_analytics): `modules/firebase_analytics`
- [Chat module](https://github.com/ensembleui/ensemble/tree/main/modules/chat): `modules/chat`

### Other components

- **App builder**
- **Declarative apps**
- **Device share intents**
- **SMS Retriever**

## Connections

- App builder → Declarative apps: configures
- Declarative apps → Linux Flutter host: runs in Starter
- Module enablement → Firebase parameters: uses parameters (evidence: `starter/src/modules_scripts.ts`)
- Module enablement → Script types: uses types (evidence: `starter/src/modules_scripts.ts`)
- Linux entry point → Linux Flutter host: creates app (evidence: `starter/linux/main.cc`)
- Linux Flutter host → Linux plugin registrar: registers plugins (evidence: `starter/linux/my_application.cc`)
- Android share receiver → Shared file handling: uses file handling (evidence: `packages/flutter_share_receiver/android/src/main/kotlin/com/kasem/receive_sharing_intent/ReceiveSharingIntentPlugin.kt`)
- Device share intents → Android share receiver: delivers intents
- Device share intents → iOS share extension: provides shared media (evidence: `packages/flutter_share_receiver/ios/Classes/RSIShareViewController.swift`)
- SMS OTP plugin → App signature helper: gets signature (evidence: `packages/ensemble_otp/android/src/main/kotlin/com/shivam/otp_pin_field/OtpPinFieldPlugin.kt`)
- SMS Retriever → SMS OTP plugin: delivers SMS
