# kasimertugrul/filmolog architecture

> Architecture diagram of the GitHub repository kasimertugrul/filmolog, 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/kasimertugrul/filmolog
- Repository: https://github.com/kasimertugrul/filmolog

## Overview

Filmolog is a Flutter film and television discovery app. Its apparent user workflow is browsing discovery or lists, opening a title or person, and exploring related details; search and collections are separate capabilities. The tree supports these feature areas and a shared API layer, but the supplied excerpts contain no Dart implementation and the README describes only a starter project. Accordingly, feature-flow links are dashed and unverified. Native host nodes capture the sampled Windows entry path and the indexed platform scaffolding, not a claimed product-data flow.

Main entry points: [`lib/app/pages/main_page.dart`](https://github.com/kasimertugrul/filmolog/blob/main/lib/app/pages/main_page.dart) (Main navigation), [`lib/features/movie/movies`](https://github.com/kasimertugrul/filmolog/tree/main/lib/features/movie/movies) (Movie details), [`lib/features/movie/search`](https://github.com/kasimertugrul/filmolog/tree/main/lib/features/movie/search) (Search), [`lib/app/app.dart`](https://github.com/kasimertugrul/filmolog/blob/main/lib/app/app.dart) (App shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_shell["App shell<br/>[app.dart]"]
  node_navigation["Main navigation<br/>[main_page.dart]"]
end

subgraph group_movie["Movie features"]
  node_discovery["Discovery"]
  node_movie_lists["Movie lists"]
  node_movie_detail["Movie details"]
  node_collections["Collections"]
  node_people["People"]
  node_search["Search"]
  node_tv["TV features<br/>[tv.dart]"]
end

subgraph group_data["Data access"]
  node_api["API client<br/>[api.dart]"]
  node_tmdb_base["TMDB base<br/>[base_tmdb.dart]"]
end

subgraph group_hosts["Platform hosts"]
  node_windows_entry["Windows entry<br/>[main.cpp]"]
  node_flutter_window["Flutter window<br/>[flutter_window.h]"]
  node_win32_window["Win32 window<br/>[win32_window.h]"]
  node_linux_host["Linux host<br/>[my_application.h]"]
  node_linux_plugins["Linux plugins"]
  node_windows_plugins["Windows plugins"]
  node_macos_plugins["macOS plugins"]
end

node_user(("Viewer"))

node_user -.->|"uses"| node_shell
node_shell -.->|"opens"| node_navigation
node_navigation -.->|"routes to"| node_discovery
node_navigation -.->|"routes to"| node_movie_lists
node_navigation -.->|"routes to"| node_search
node_discovery -.->|"opens title"| node_movie_detail
node_movie_lists -.->|"opens title"| node_movie_detail
node_movie_detail -.->|"shows collection"| node_collections
node_movie_detail -.->|"links people"| node_people
node_search -.->|"opens title"| node_movie_detail
node_search -.->|"opens person"| node_people
node_navigation -.->|"routes to"| node_tv
node_windows_entry -->|"creates"| node_flutter_window
node_flutter_window -->|"extends"| node_win32_window

click node_shell "https://github.com/kasimertugrul/filmolog/blob/main/lib/app/app.dart"
click node_navigation "https://github.com/kasimertugrul/filmolog/blob/main/lib/app/pages/main_page.dart"
click node_discovery "https://github.com/kasimertugrul/filmolog/tree/main/lib/features/movie/discovery"
click node_movie_lists "https://github.com/kasimertugrul/filmolog/tree/main/lib/features/movie/movie_list"
click node_movie_detail "https://github.com/kasimertugrul/filmolog/tree/main/lib/features/movie/movies"
click node_collections "https://github.com/kasimertugrul/filmolog/tree/main/lib/features/movie/collection"
click node_people "https://github.com/kasimertugrul/filmolog/tree/main/lib/features/movie/people"
click node_search "https://github.com/kasimertugrul/filmolog/tree/main/lib/features/movie/search"
click node_tv "https://github.com/kasimertugrul/filmolog/blob/main/lib/features/tv/tv.dart"
click node_api "https://github.com/kasimertugrul/filmolog/blob/main/lib/core/api/api.dart"
click node_tmdb_base "https://github.com/kasimertugrul/filmolog/blob/main/lib/core/base/base_tmdb/base_tmdb.dart"
click node_windows_entry "https://github.com/kasimertugrul/filmolog/blob/main/windows/runner/main.cpp"
click node_flutter_window "https://github.com/kasimertugrul/filmolog/blob/main/windows/runner/flutter_window.h"
click node_win32_window "https://github.com/kasimertugrul/filmolog/blob/main/windows/runner/win32_window.h"
click node_linux_host "https://github.com/kasimertugrul/filmolog/blob/main/linux/my_application.h"
click node_linux_plugins "https://github.com/kasimertugrul/filmolog/blob/main/linux/flutter/generated_plugin_registrant.h"
click node_windows_plugins "https://github.com/kasimertugrul/filmolog/blob/main/windows/flutter/generated_plugin_registrant.h"
click node_macos_plugins "https://github.com/kasimertugrul/filmolog/blob/main/macos/Flutter/GeneratedPluginRegistrant.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_shell,node_navigation,node_user toneBlue
class node_discovery,node_movie_lists,node_movie_detail,node_collections,node_people,node_search,node_tv toneAmber
class node_api,node_tmdb_base toneMint
class node_windows_entry,node_flutter_window,node_win32_window,node_linux_host,node_linux_plugins,node_windows_plugins,node_macos_plugins toneRose
```

## Components

### App experience

- [App shell](https://github.com/kasimertugrul/filmolog/blob/main/lib/app/app.dart): `lib/app/app.dart`
- [Main navigation](https://github.com/kasimertugrul/filmolog/blob/main/lib/app/pages/main_page.dart): `lib/app/pages/main_page.dart`

### Movie features

- [Discovery](https://github.com/kasimertugrul/filmolog/tree/main/lib/features/movie/discovery): `lib/features/movie/discovery`
- [Movie lists](https://github.com/kasimertugrul/filmolog/tree/main/lib/features/movie/movie_list): `lib/features/movie/movie_list`
- [Movie details](https://github.com/kasimertugrul/filmolog/tree/main/lib/features/movie/movies): `lib/features/movie/movies`
- [Collections](https://github.com/kasimertugrul/filmolog/tree/main/lib/features/movie/collection): `lib/features/movie/collection`
- [People](https://github.com/kasimertugrul/filmolog/tree/main/lib/features/movie/people): `lib/features/movie/people`
- [Search](https://github.com/kasimertugrul/filmolog/tree/main/lib/features/movie/search): `lib/features/movie/search`
- [TV features](https://github.com/kasimertugrul/filmolog/blob/main/lib/features/tv/tv.dart): `lib/features/tv/tv.dart`

### Data access

- [API client](https://github.com/kasimertugrul/filmolog/blob/main/lib/core/api/api.dart): `lib/core/api/api.dart`
- [TMDB base](https://github.com/kasimertugrul/filmolog/blob/main/lib/core/base/base_tmdb/base_tmdb.dart): `lib/core/base/base_tmdb/base_tmdb.dart`

### Platform hosts

- [Windows entry](https://github.com/kasimertugrul/filmolog/blob/main/windows/runner/main.cpp): `windows/runner/main.cpp`
- [Flutter window](https://github.com/kasimertugrul/filmolog/blob/main/windows/runner/flutter_window.h): `windows/runner/flutter_window.h`
- [Win32 window](https://github.com/kasimertugrul/filmolog/blob/main/windows/runner/win32_window.h): `windows/runner/win32_window.h`
- [Linux host](https://github.com/kasimertugrul/filmolog/blob/main/linux/my_application.h): `linux/my_application.h`
- [Linux plugins](https://github.com/kasimertugrul/filmolog/blob/main/linux/flutter/generated_plugin_registrant.h): `linux/flutter/generated_plugin_registrant.h`
- [Windows plugins](https://github.com/kasimertugrul/filmolog/blob/main/windows/flutter/generated_plugin_registrant.h): `windows/flutter/generated_plugin_registrant.h`
- [macOS plugins](https://github.com/kasimertugrul/filmolog/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift): `macos/Flutter/GeneratedPluginRegistrant.swift`

### Other components

- **Viewer**

## Connections

- Viewer → App shell: uses
- App shell → Main navigation: opens
- Main navigation → Discovery: routes to
- Main navigation → Movie lists: routes to
- Main navigation → Search: routes to
- Discovery → Movie details: opens title
- Movie lists → Movie details: opens title
- Movie details → Collections: shows collection
- Movie details → People: links people
- Search → Movie details: opens title
- Search → People: opens person
- Main navigation → TV features: routes to
- Windows entry → Flutter window: creates (evidence: `windows/runner/main.cpp`)
- Flutter window → Win32 window: extends (evidence: `windows/runner/flutter_window.h`)
