# yang991178/fluent-reader-lite architecture

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

- Interactive diagram: https://gitdiagram.com/yang991178/fluent-reader-lite
- Repository: https://github.com/yang991178/fluent-reader-lite

## Overview

Fluent Reader Lite is a cross-platform mobile RSS client. Its documented user journey is to connect a supported RSS service, browse and filter synced articles, and read article content; subscriptions, groups, search, dark mode, and tablet layouts are additional capabilities. The tree identifies likely Flutter modules, but the supplied source excerpts only show iOS platform code, so most app-internal connections are unverified and omitted. Service support and product capabilities are documented in the README.

Main entry points: [`lib/models/services/feedbin.dart`](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/models/services/feedbin.dart) (Feedbin adapter), [`lib/models/services/fever.dart`](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/models/services/fever.dart) (Fever adapter), [`lib/models/services/greader.dart`](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/models/services/greader.dart) (Google Reader adapter), [`lib/pages/settings/services/inoreader_page.dart`](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/pages/settings/services/inoreader_page.dart) (Inoreader settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Mobile app"]
  node_application["Flutter app<br/>[main.dart]"]
  node_home["Home and setup<br/>[home_page.dart]"]
  node_subscriptions["Subscriptions"]
  node_settings["Settings<br/>[settings_page.dart]"]
end

subgraph group_content["Feeds and reading"]
  node_groups["Feed groups<br/>[groups_model.dart]"]
  node_sources["Feed sources<br/>[sources_model.dart]"]
  node_articles["Article lists"]
  node_article["Article reader<br/>[article_page.dart]"]
  node_parser["Mercury parser<br/>[mercury.web.js]"]
  node_storage[("Local database<br/>[db.dart]")]
end

subgraph group_services["RSS services"]
  node_sync["Sync model<br/>[sync_model.dart]"]
  node_feedbin["Feedbin adapter<br/>[feedbin.dart]"]
  node_fever["Fever adapter<br/>[fever.dart]"]
  node_greader["Google Reader adapter<br/>[greader.dart]"]
  node_inoreader["Inoreader settings"]
end

subgraph group_platform["Platform integration"]
  node_ios_host["iOS host<br/>[AppDelegate.swift]"]
end

node_user(("Reader"))
node_feedbin_api["Feedbin service"]
node_fever_api["Fever-compatible service"]
node_greader_api["Google Reader-compatible service"]
node_inoreader_api["Inoreader service"]

node_user -.->|"uses"| node_application
node_feedbin -.->|"connects to"| node_feedbin_api
node_fever -.->|"connects to"| node_fever_api
node_greader -.->|"connects to"| node_greader_api
node_inoreader -.->|"configures"| node_inoreader_api

click node_application "https://github.com/yang991178/fluent-reader-lite/blob/master/lib/main.dart"
click node_home "https://github.com/yang991178/fluent-reader-lite/blob/master/lib/pages/home_page.dart"
click node_subscriptions "https://github.com/yang991178/fluent-reader-lite/blob/master/lib/pages/subscription_list_page.dart"
click node_settings "https://github.com/yang991178/fluent-reader-lite/blob/master/lib/pages/settings_page.dart"
click node_groups "https://github.com/yang991178/fluent-reader-lite/blob/master/lib/models/groups_model.dart"
click node_sources "https://github.com/yang991178/fluent-reader-lite/blob/master/lib/models/sources_model.dart"
click node_articles "https://github.com/yang991178/fluent-reader-lite/blob/master/lib/pages/item_list_page.dart"
click node_article "https://github.com/yang991178/fluent-reader-lite/blob/master/lib/pages/article_page.dart"
click node_parser "https://github.com/yang991178/fluent-reader-lite/blob/master/assets/article/mercury.web.js"
click node_storage "https://github.com/yang991178/fluent-reader-lite/blob/master/lib/utils/db.dart"
click node_sync "https://github.com/yang991178/fluent-reader-lite/blob/master/lib/models/sync_model.dart"
click node_feedbin "https://github.com/yang991178/fluent-reader-lite/blob/master/lib/models/services/feedbin.dart"
click node_fever "https://github.com/yang991178/fluent-reader-lite/blob/master/lib/models/services/fever.dart"
click node_greader "https://github.com/yang991178/fluent-reader-lite/blob/master/lib/models/services/greader.dart"
click node_inoreader "https://github.com/yang991178/fluent-reader-lite/blob/master/lib/pages/settings/services/inoreader_page.dart"
click node_ios_host "https://github.com/yang991178/fluent-reader-lite/blob/master/ios/Runner/AppDelegate.swift"

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_application,node_home,node_subscriptions,node_settings toneBlue
class node_groups,node_sources,node_articles,node_article,node_parser,node_storage toneAmber
class node_sync,node_feedbin,node_fever,node_greader,node_inoreader toneMint
class node_ios_host toneRose
class node_user,node_feedbin_api,node_fever_api,node_greader_api,node_inoreader_api toneIndigo
```

## Components

### Mobile app

- [Flutter app](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/main.dart): `lib/main.dart`
- [Home and setup](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/pages/home_page.dart): `lib/pages/home_page.dart`
- [Subscriptions](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/pages/subscription_list_page.dart): `lib/pages/subscription_list_page.dart`
- [Settings](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/pages/settings_page.dart): `lib/pages/settings_page.dart`

### Feeds and reading

- [Feed groups](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/models/groups_model.dart): `lib/models/groups_model.dart`
- [Feed sources](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/models/sources_model.dart): `lib/models/sources_model.dart`
- [Article lists](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/pages/item_list_page.dart): `lib/pages/item_list_page.dart`
- [Article reader](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/pages/article_page.dart): `lib/pages/article_page.dart`
- [Mercury parser](https://github.com/yang991178/fluent-reader-lite/blob/master/assets/article/mercury.web.js): `assets/article/mercury.web.js`
- [Local database](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/utils/db.dart): `lib/utils/db.dart`

### RSS services

- [Sync model](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/models/sync_model.dart): `lib/models/sync_model.dart`
- [Feedbin adapter](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/models/services/feedbin.dart): `lib/models/services/feedbin.dart`
- [Fever adapter](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/models/services/fever.dart): `lib/models/services/fever.dart`
- [Google Reader adapter](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/models/services/greader.dart): `lib/models/services/greader.dart`
- [Inoreader settings](https://github.com/yang991178/fluent-reader-lite/blob/master/lib/pages/settings/services/inoreader_page.dart): `lib/pages/settings/services/inoreader_page.dart`

### Platform integration

- [iOS host](https://github.com/yang991178/fluent-reader-lite/blob/master/ios/Runner/AppDelegate.swift): `ios/Runner/AppDelegate.swift`

### Other components

- **Reader**
- **Feedbin service**
- **Fever-compatible service**
- **Google Reader-compatible service**
- **Inoreader service**

## Connections

- Reader → Flutter app: uses
- Feedbin adapter → Feedbin service: connects to
- Fever adapter → Fever-compatible service: connects to
- Google Reader adapter → Google Reader-compatible service: connects to
- Inoreader settings → Inoreader service: configures
