# ruxakk/livekit_flutter_starter architecture

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

- Interactive diagram: https://gitdiagram.com/ruxakk/livekit_flutter_starter
- Repository: https://github.com/ruxakk/livekit_flutter_starter

## Overview

Flutter Agent Starter is a cross-platform LiveKit voice-assistant client. Users enter the app, connect to an agent, and interact through voice or text, with optional camera or screen-share input; agent video is rendered when available, otherwise an audio visualizer is shown. The README describes Session and media contexts, but Dart implementation excerpts were not provided, so detailed call ownership and UI wiring cannot be verified; edges below reflect documented relationships only.

Main entry points: [`lib/screens/agent_screen.dart`](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/screens/agent_screen.dart) (Agent screen), [`lib/controllers/app_ctrl.dart`](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/controllers/app_ctrl.dart) (App controller), [`lib/main.dart`](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/main.dart) (Flutter entry), [`lib/screens/welcome_screen.dart`](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/screens/welcome_screen.dart) (Welcome screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App flow"]
  node_entry["Flutter entry<br/>[main.dart]"]
  node_app_shell["App shell<br/>[app.dart]"]
  node_welcome["Welcome screen"]
  node_selector["Agent selector"]
end

subgraph group_session["Session and media"]
  node_controller["App controller<br/>[app_ctrl.dart]"]
  node_session["LiveKit session"]
  node_media["Media contexts"]
  node_token_source["Token source<br/>[app_ctrl.dart]"]
end

subgraph group_interaction["User interaction"]
  node_control_bar["Control bar<br/>[control_bar.dart]"]
  node_message_bar["Message bar<br/>[message_bar.dart]"]
  node_camera_toggle["Camera toggle"]
end

subgraph group_presentation["Agent presentation"]
  node_agent_screen["Agent screen<br/>[agent_screen.dart]"]
  node_agent_video["Agent video<br/>[agent_screen.dart]"]
  node_status["Agent status"]
  node_layout["Layout controls"]
end

node_user(("User"))
node_agent(("LiveKit agent"))
node_token_server["Token server"]

node_user -->|"opens"| node_entry
node_entry -.->|"starts"| node_app_shell
node_user -->|"chooses agent"| node_welcome
node_welcome -.->|"selects agent"| node_selector
node_controller -->|"configures"| node_token_source
node_token_source -->|"requests tokens"| node_token_server
node_controller -->|"creates session"| node_session
node_session -->|"connects and dispatches"| node_agent
node_session -->|"manages media"| node_media
node_user -->|"controls input"| node_control_bar
node_user -->|"sends text"| node_message_bar
node_user -->|"shares video"| node_camera_toggle
node_session -.->|"provides session"| node_agent_screen
node_agent_screen -->|"renders video or visualizer"| node_agent_video
node_agent_screen -.->|"shows status"| node_status
node_user -.->|"switches layout"| node_layout

click node_entry "https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/main.dart"
click node_app_shell "https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/app.dart"
click node_welcome "https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/screens/welcome_screen.dart"
click node_selector "https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/support/agent_selector.dart"
click node_controller "https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/controllers/app_ctrl.dart"
click node_token_source "https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/controllers/app_ctrl.dart"
click node_agent_screen "https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/screens/agent_screen.dart"
click node_control_bar "https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/widgets/control_bar.dart"
click node_message_bar "https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/widgets/message_bar.dart"
click node_camera_toggle "https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/widgets/camera_toggle_button.dart"
click node_agent_video "https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/screens/agent_screen.dart"
click node_status "https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/widgets/agent_status_indicator.dart"
click node_layout "https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/widgets/agent_layout_switcher.dart"

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_entry,node_app_shell,node_welcome,node_selector,node_user toneBlue
class node_controller,node_session,node_media,node_token_source toneAmber
class node_control_bar,node_message_bar,node_camera_toggle,node_token_server toneMint
class node_agent_screen,node_agent_video,node_status,node_layout toneRose
class node_agent toneIndigo
```

## Components

### App flow

- [Flutter entry](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/main.dart): `lib/main.dart`
- [App shell](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/app.dart): `lib/app.dart`
- [Welcome screen](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/screens/welcome_screen.dart): `lib/screens/welcome_screen.dart`
- [Agent selector](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/support/agent_selector.dart): `lib/support/agent_selector.dart`

### Session and media

- [App controller](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/controllers/app_ctrl.dart): `lib/controllers/app_ctrl.dart`
- **LiveKit session**
- **Media contexts**
- [Token source](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/controllers/app_ctrl.dart): `lib/controllers/app_ctrl.dart`

### User interaction

- [Control bar](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/widgets/control_bar.dart): `lib/widgets/control_bar.dart`
- [Message bar](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/widgets/message_bar.dart): `lib/widgets/message_bar.dart`
- [Camera toggle](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/widgets/camera_toggle_button.dart): `lib/widgets/camera_toggle_button.dart`

### Agent presentation

- [Agent screen](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/screens/agent_screen.dart): `lib/screens/agent_screen.dart`
- [Agent video](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/screens/agent_screen.dart): `lib/screens/agent_screen.dart`
- [Agent status](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/widgets/agent_status_indicator.dart): `lib/widgets/agent_status_indicator.dart`
- [Layout controls](https://github.com/ruxakk/livekit_flutter_starter/blob/main/lib/widgets/agent_layout_switcher.dart): `lib/widgets/agent_layout_switcher.dart`

### Other components

- **User**
- **LiveKit agent**
- **Token server**

## Connections

- User → Flutter entry: opens (evidence: `README.md`)
- Flutter entry → App shell: starts
- User → Welcome screen: chooses agent (evidence: `README.md`)
- Welcome screen → Agent selector: selects agent
- App controller → Token source: configures (evidence: `README.md`)
- Token source → Token server: requests tokens (evidence: `README.md`)
- App controller → LiveKit session: creates session (evidence: `README.md`)
- LiveKit session → LiveKit agent: connects and dispatches (evidence: `README.md`)
- LiveKit session → Media contexts: manages media (evidence: `README.md`)
- User → Control bar: controls input (evidence: `README.md`)
- User → Message bar: sends text (evidence: `README.md`)
- User → Camera toggle: shares video (evidence: `README.md`)
- LiveKit session → Agent screen: provides session
- Agent screen → Agent video: renders video or visualizer (evidence: `README.md`)
- Agent screen → Agent status: shows status
- User → Layout controls: switches layout
