# rtfmko/fluent_bar architecture

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

- Interactive diagram: https://gitdiagram.com/rtfmko/fluent_bar
- Repository: https://github.com/rtfmko/fluent_bar

## Overview

fluent_bar is a Flutter notification-bar package. An app invokes its context-free API; bars are configured, queued by screen region, and displayed in an overlay, where callers can update or close them. The README also documents progress tasks, customizable builders, themes and types, settings precedence, analytics, error recovery, accessibility, and inset handling. Paths identify implementation areas from the tree; source excerpts were unavailable, so edges are limited to relationships explicitly described in the README.

Main entry points: [`lib/src/manager/fluent_bar_manager.dart`](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/manager/fluent_bar_manager.dart) (Bar manager), [`lib/src/models/fluent_bar_item.dart`](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/models/fluent_bar_item.dart) (Bar configuration), [`lib/src/facade/fluent_bar.dart`](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/facade/fluent_bar.dart) (FluentBar API), [`lib/src/manager/parts/manager_queue.dart`](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/manager/parts/manager_queue.dart) (Regional queue)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Public API"]
  node_api["FluentBar API<br/>[fluent_bar.dart]"]
  node_scope["Overlay setup"]
end

subgraph group_orchestration["Bar orchestration"]
  node_manager["Bar manager"]
  node_queue["Regional queue<br/>[manager_queue.dart]"]
  node_strategies["Queue strategies"]
  node_controller["Bar controller"]
  node_analytics["Analytics"]
  node_errors["Error handling"]
end

subgraph group_presentation["Presentation"]
  node_overlay["Overlay placement"]
  node_widgets["Bar widgets"]
  node_insets["Screen insets"]
end

subgraph group_capabilities["Bar capabilities"]
  node_items["Bar configuration"]
  node_progress["Progress state"]
  node_types["Types and themes"]
  node_builders["Custom builders"]
  node_config["Global settings"]
end

node_app(("Flutter app"))

node_app -->|"shows bars"| node_api
node_app -->|"sets up overlay"| node_scope
node_api -->|"manages bars"| node_manager
node_manager -->|"queues by region"| node_queue
node_queue -->|"orders waiting bars"| node_strategies
node_manager -->|"displays bars"| node_overlay
node_overlay -->|"shows bars"| node_widgets
node_app -->|"updates bars"| node_controller
node_manager -->|"reports events"| node_analytics
node_manager -->|"recovers failures"| node_errors
node_app -->|"supplies options"| node_items
node_items -->|"tracks progress"| node_progress
node_items -->|"uses defaults"| node_types
node_items -->|"customizes parts"| node_builders
node_items -->|"resolves settings"| node_config
node_app -->|"wraps app bars"| node_insets

click node_api "https://github.com/rtfmko/fluent_bar/blob/main/lib/src/facade/fluent_bar.dart"
click node_scope "https://github.com/rtfmko/fluent_bar/blob/main/lib/src/facade/fluent_bar_scope.dart"
click node_manager "https://github.com/rtfmko/fluent_bar/blob/main/lib/src/manager/fluent_bar_manager.dart"
click node_queue "https://github.com/rtfmko/fluent_bar/blob/main/lib/src/manager/parts/manager_queue.dart"
click node_strategies "https://github.com/rtfmko/fluent_bar/tree/main/lib/src/strategies"
click node_controller "https://github.com/rtfmko/fluent_bar/blob/main/lib/src/controllers/fluent_bar_controller_impl.dart"
click node_analytics "https://github.com/rtfmko/fluent_bar/blob/main/lib/src/manager/parts/manager_analytics.dart"
click node_errors "https://github.com/rtfmko/fluent_bar/blob/main/lib/src/manager/parts/manager_error_handler.dart"
click node_overlay "https://github.com/rtfmko/fluent_bar/blob/main/lib/src/manager/parts/manager_overlay.dart"
click node_widgets "https://github.com/rtfmko/fluent_bar/blob/main/lib/src/widgets/default_fluent_bar_widget.dart"
click node_insets "https://github.com/rtfmko/fluent_bar/blob/main/lib/src/widgets/fluent_bar_bottom_inset.dart"
click node_items "https://github.com/rtfmko/fluent_bar/blob/main/lib/src/models/fluent_bar_item.dart"
click node_progress "https://github.com/rtfmko/fluent_bar/blob/main/lib/src/models/progress/fluent_bar_progress_state.dart"
click node_types "https://github.com/rtfmko/fluent_bar/blob/main/lib/src/interfaces/fluent_bar_type.dart"
click node_builders "https://github.com/rtfmko/fluent_bar/blob/main/lib/src/extensions/fluent_bar_builder_extensions.dart"
click node_config "https://github.com/rtfmko/fluent_bar/blob/main/lib/src/models/fluent_bar_config.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_api,node_scope toneBlue
class node_manager,node_queue,node_strategies,node_controller,node_analytics,node_errors toneAmber
class node_overlay,node_widgets,node_insets toneMint
class node_items,node_progress,node_types,node_builders,node_config toneRose
class node_app toneIndigo
```

## Components

### Public API

- [FluentBar API](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/facade/fluent_bar.dart): `lib/src/facade/fluent_bar.dart`
- [Overlay setup](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/facade/fluent_bar_scope.dart): `lib/src/facade/fluent_bar_scope.dart`

### Bar orchestration

- [Bar manager](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/manager/fluent_bar_manager.dart): `lib/src/manager/fluent_bar_manager.dart`
- [Regional queue](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/manager/parts/manager_queue.dart): `lib/src/manager/parts/manager_queue.dart`
- [Queue strategies](https://github.com/rtfmko/fluent_bar/tree/main/lib/src/strategies): `lib/src/strategies`
- [Bar controller](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/controllers/fluent_bar_controller_impl.dart): `lib/src/controllers/fluent_bar_controller_impl.dart`
- [Analytics](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/manager/parts/manager_analytics.dart): `lib/src/manager/parts/manager_analytics.dart`
- [Error handling](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/manager/parts/manager_error_handler.dart): `lib/src/manager/parts/manager_error_handler.dart`

### Presentation

- [Overlay placement](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/manager/parts/manager_overlay.dart): `lib/src/manager/parts/manager_overlay.dart`
- [Bar widgets](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/widgets/default_fluent_bar_widget.dart): `lib/src/widgets/default_fluent_bar_widget.dart`
- [Screen insets](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/widgets/fluent_bar_bottom_inset.dart): `lib/src/widgets/fluent_bar_bottom_inset.dart`

### Bar capabilities

- [Bar configuration](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/models/fluent_bar_item.dart): `lib/src/models/fluent_bar_item.dart`
- [Progress state](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/models/progress/fluent_bar_progress_state.dart): `lib/src/models/progress/fluent_bar_progress_state.dart`
- [Types and themes](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/interfaces/fluent_bar_type.dart): `lib/src/interfaces/fluent_bar_type.dart`
- [Custom builders](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/extensions/fluent_bar_builder_extensions.dart): `lib/src/extensions/fluent_bar_builder_extensions.dart`
- [Global settings](https://github.com/rtfmko/fluent_bar/blob/main/lib/src/models/fluent_bar_config.dart): `lib/src/models/fluent_bar_config.dart`

### Other components

- **Flutter app**

## Connections

- Flutter app → FluentBar API: shows bars (evidence: `README.md`)
- Flutter app → Overlay setup: sets up overlay (evidence: `README.md`)
- FluentBar API → Bar manager: manages bars (evidence: `README.md`)
- Bar manager → Regional queue: queues by region (evidence: `README.md`)
- Regional queue → Queue strategies: orders waiting bars (evidence: `README.md`)
- Bar manager → Overlay placement: displays bars (evidence: `README.md`)
- Overlay placement → Bar widgets: shows bars (evidence: `README.md`)
- Flutter app → Bar controller: updates bars (evidence: `README.md`)
- Bar manager → Analytics: reports events (evidence: `README.md`)
- Bar manager → Error handling: recovers failures (evidence: `README.md`)
- Flutter app → Bar configuration: supplies options (evidence: `README.md`)
- Bar configuration → Progress state: tracks progress (evidence: `README.md`)
- Bar configuration → Types and themes: uses defaults (evidence: `README.md`)
- Bar configuration → Custom builders: customizes parts (evidence: `README.md`)
- Bar configuration → Global settings: resolves settings (evidence: `README.md`)
- Flutter app → Screen insets: wraps app bars (evidence: `README.md`)
