# baseflow/flutter_cache_manager architecture

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

- Interactive diagram: https://gitdiagram.com/baseflow/flutter_cache_manager
- Repository: https://github.com/baseflow/flutter_cache_manager

## Overview

flutter_cache_manager is a Dart/Flutter library for downloading files, caching them locally, and serving cached or refreshed results. The documented workflow starts with an app requesting a file from a CacheManager; cached content can be returned immediately, while stale or missing content can be fetched and cached. It also supports image resizing, cache management, configurable storage, and a separate Firebase Storage implementation. Relationships below rely on README documentation; source excerpts were not provided, so internal call details are not asserted.

Main entry points: [`flutter_cache_manager/lib/src/cache_manager.dart`](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/cache_manager.dart) (Cache manager), [`flutter_cache_manager/lib/src/web/web_helper.dart`](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/web/web_helper.dart) (File fetching), [`flutter_cache_manager/lib/src/cache_store.dart`](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/cache_store.dart) (Cache store), [`flutter_cache_manager_firebase/lib/src/firebase_cache_manager.dart`](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager_firebase/lib/src/firebase_cache_manager.dart) (Firebase manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Cache API"]
  node_manager["Cache manager<br/>[cache_manager.dart]"]
  node_config["Cache config<br/>[config.dart]"]
  node_default["Default manager"]
  node_base["Manager interface"]
  node_cache_ops["Cache operations<br/>[cache_manager.dart]"]
end

subgraph group_runtime["Fetch and Images"]
  node_fetch["File fetching<br/>[web_helper.dart]"]
  node_http["HTTP service<br/>[file_service.dart]"]
  node_progress["Download progress"]
  node_image["Image resizing"]
  node_response["File responses<br/>[file_response.dart]"]
end

subgraph group_storage["Cache Storage"]
  node_cache_store["Cache store<br/>[cache_store.dart]"]
  node_metadata[("Cache metadata")]
  node_file_system["File system<br/>[file_system.dart]"]
end

subgraph group_integrations["Platform Integrations"]
  node_firebase_manager["Firebase manager"]
  node_firebase_http["Firebase HTTP service"]
end

node_app(("Flutter app"))
node_firebase_storage["Firebase Storage"]

node_app -->|"requests files"| node_manager
node_app -->|"manages cache"| node_manager
node_default -->|"provides manager"| node_manager
node_manager -->|"uses settings"| node_config
node_manager -.->|"downloads files"| node_fetch
node_manager -.->|"uses cache"| node_cache_store
node_manager -->|"returns files"| node_response
node_fetch -.->|"fetches remotely"| node_http
node_fetch -->|"emits progress"| node_progress
node_manager -->|"gets resized images"| node_image
node_image -->|"streams images"| node_response
node_cache_store -->|"tracks metadata"| node_metadata
node_cache_store -->|"stores files"| node_file_system
node_manager -->|"supports cache changes"| node_cache_ops
node_firebase_manager -.->|"uses service"| node_firebase_http
node_firebase_manager -->|"supports storage"| node_firebase_storage

click node_manager "https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/cache_manager.dart"
click node_config "https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/config/config.dart"
click node_default "https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/cache_managers/default_cache_manager.dart"
click node_base "https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/cache_managers/base_cache_manager.dart"
click node_cache_ops "https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/cache_manager.dart"
click node_fetch "https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/web/web_helper.dart"
click node_http "https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/web/file_service.dart"
click node_progress "https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/result/download_progress.dart"
click node_image "https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/cache_managers/image_cache_manager.dart"
click node_response "https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/result/file_response.dart"
click node_cache_store "https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/cache_store.dart"
click node_metadata "https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/storage/cache_info_repositories/cache_info_repository.dart"
click node_file_system "https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/storage/file_system/file_system.dart"
click node_firebase_manager "https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager_firebase/lib/src/firebase_cache_manager.dart"
click node_firebase_http "https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager_firebase/lib/src/firebase_http_file_service.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_manager,node_config,node_default,node_base,node_cache_ops toneBlue
class node_fetch,node_http,node_progress,node_image,node_response,node_firebase_storage toneAmber
class node_cache_store,node_metadata,node_file_system toneMint
class node_firebase_manager,node_firebase_http toneRose
class node_app toneIndigo
```

## Components

### Cache API

- [Cache manager](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/cache_manager.dart): `flutter_cache_manager/lib/src/cache_manager.dart`
- [Cache config](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/config/config.dart): `flutter_cache_manager/lib/src/config/config.dart`
- [Default manager](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/cache_managers/default_cache_manager.dart): `flutter_cache_manager/lib/src/cache_managers/default_cache_manager.dart`
- [Manager interface](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/cache_managers/base_cache_manager.dart): `flutter_cache_manager/lib/src/cache_managers/base_cache_manager.dart`
- [Cache operations](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/cache_manager.dart): `flutter_cache_manager/lib/src/cache_manager.dart`

### Fetch and Images

- [File fetching](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/web/web_helper.dart): `flutter_cache_manager/lib/src/web/web_helper.dart`
- [HTTP service](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/web/file_service.dart): `flutter_cache_manager/lib/src/web/file_service.dart`
- [Download progress](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/result/download_progress.dart): `flutter_cache_manager/lib/src/result/download_progress.dart`
- [Image resizing](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/cache_managers/image_cache_manager.dart): `flutter_cache_manager/lib/src/cache_managers/image_cache_manager.dart`
- [File responses](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/result/file_response.dart): `flutter_cache_manager/lib/src/result/file_response.dart`

### Cache Storage

- [Cache store](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/cache_store.dart): `flutter_cache_manager/lib/src/cache_store.dart`
- [Cache metadata](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/storage/cache_info_repositories/cache_info_repository.dart): `flutter_cache_manager/lib/src/storage/cache_info_repositories/cache_info_repository.dart`
- [File system](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager/lib/src/storage/file_system/file_system.dart): `flutter_cache_manager/lib/src/storage/file_system/file_system.dart`

### Platform Integrations

- [Firebase manager](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager_firebase/lib/src/firebase_cache_manager.dart): `flutter_cache_manager_firebase/lib/src/firebase_cache_manager.dart`
- [Firebase HTTP service](https://github.com/baseflow/flutter_cache_manager/blob/main/flutter_cache_manager_firebase/lib/src/firebase_http_file_service.dart): `flutter_cache_manager_firebase/lib/src/firebase_http_file_service.dart`

### Other components

- **Flutter app**
- **Firebase Storage**

## Connections

- Flutter app → Cache manager: requests files (evidence: `README.md`)
- Flutter app → Cache manager: manages cache (evidence: `README.md`)
- Default manager → Cache manager: provides manager (evidence: `README.md`)
- Cache manager → Cache config: uses settings (evidence: `README.md`)
- Cache manager → File fetching: downloads files
- Cache manager → Cache store: uses cache
- Cache manager → File responses: returns files (evidence: `README.md`)
- File fetching → HTTP service: fetches remotely
- File fetching → Download progress: emits progress (evidence: `README.md`)
- Cache manager → Image resizing: gets resized images (evidence: `README.md`)
- Image resizing → File responses: streams images (evidence: `README.md`)
- Cache store → Cache metadata: tracks metadata (evidence: `README.md`)
- Cache store → File system: stores files (evidence: `README.md`)
- Cache manager → Cache operations: supports cache changes (evidence: `README.md`)
- Firebase manager → Firebase HTTP service: uses service
- Firebase manager → Firebase Storage: supports storage (evidence: `README.md`)
