# ultra-filter/flixerch architecture

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

- Interactive diagram: https://gitdiagram.com/ultra-filter/flixerch
- Repository: https://github.com/ultra-filter/flixerch

## Overview

Flixerch is an in-development media app; the shown runtime currently initializes a window and UI, then runs an input/update/render loop. Its documented target includes rendering images and fetching online content, while search, recommendations, database, and media-decoding stages are not represented as implemented workflows in the sampled runtime. The graph preserves the renderer, UI, and web-client subsystems; several renderer and UI links are dashed because their implementation calls were not shown.

Main entry points: [`src/frontend/ui/ui.c`](https://github.com/ultra-filter/flixerch/blob/main/src/frontend/ui/ui.c) (UI system), [`src/frontend/renderer/quad_renderer.c`](https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/quad_renderer.c) (Quad renderer), [`src/app.c`](https://github.com/ultra-filter/flixerch/blob/main/src/app.c) (App lifecycle), [`src/frontend/renderer/image_renderer.c`](https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/image_renderer.c) (Image renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_app_entry["App lifecycle<br/>[app.c]"]
end

subgraph group_front["Frontend"]
  node_ui["UI system<br/>[ui.c]"]
  node_ui_contract["UI interface<br/>[ui_interface.h]"]
end

subgraph group_render["Rendering"]
  node_window["Window and input<br/>[window.c]"]
  node_quad["Quad renderer<br/>[quad_renderer.c]"]
  node_batch["Quad batching<br/>[quad_batch.c]"]
  node_images["Image renderer<br/>[image_renderer.c]"]
  node_assets["Asset loading<br/>[assets_loader.c]"]
  node_fonts["Font rendering<br/>[font.c]"]
  node_colors["Color utilities<br/>[color.c]"]
  node_gl["OpenGL loader<br/>[glad.c]"]
end

subgraph group_backend["Web access"]
  node_web["HTTP client<br/>[web_client.c]"]
end

subgraph group_core["Core utilities"]
  node_math["Math engine<br/>[math_engine.c]"]
  node_decoder["Image decoding<br/>[stb_image.c]"]
  node_containers["Data structures"]
end

node_user(("User"))
node_curl["libcurl"]
node_online(("Online resources"))

node_user -->|"launches"| node_app_entry
node_app_entry -->|"initializes and runs"| node_window
node_app_entry -->|"initializes and shuts down"| node_ui
node_ui -->|"implements interface"| node_ui_contract
node_ui -->|"uses structures"| node_containers
node_ui -.->|"renders through"| node_quad
node_ui -.->|"queries window"| node_window
node_quad -.->|"uses batching"| node_batch
node_quad -.->|"uses math"| node_math
node_images -.->|"loads assets"| node_assets
node_images -.->|"decodes images"| node_decoder
node_quad -.->|"uses OpenGL"| node_gl
node_web -->|"performs requests"| node_curl
node_web -.->|"fetches content"| node_online

click node_app_entry "https://github.com/ultra-filter/flixerch/blob/main/src/app.c"
click node_window "https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/window.c"
click node_ui "https://github.com/ultra-filter/flixerch/blob/main/src/frontend/ui/ui.c"
click node_ui_contract "https://github.com/ultra-filter/flixerch/blob/main/src/frontend/ui/ui_interface.h"
click node_quad "https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/quad_renderer.c"
click node_batch "https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/quad_batch.c"
click node_images "https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/image_renderer.c"
click node_assets "https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/assets_loader.c"
click node_fonts "https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/font.c"
click node_colors "https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/color.c"
click node_gl "https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/glad.c"
click node_math "https://github.com/ultra-filter/flixerch/blob/main/src/core/utils/math_engine.c"
click node_decoder "https://github.com/ultra-filter/flixerch/blob/main/src/core/decoders/stb_image.c"
click node_containers "https://github.com/ultra-filter/flixerch/tree/main/src/core/utils/containers"
click node_web "https://github.com/ultra-filter/flixerch/blob/main/src/backend/web/web_client.c"

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_app_entry,node_user toneBlue
class node_ui,node_ui_contract toneAmber
class node_window,node_quad,node_batch,node_images,node_assets,node_fonts,node_colors,node_gl toneMint
class node_web toneRose
class node_math,node_decoder,node_containers,node_curl,node_online toneIndigo
```

## Components

### Application

- [App lifecycle](https://github.com/ultra-filter/flixerch/blob/main/src/app.c): `src/app.c`

### Frontend

- [UI system](https://github.com/ultra-filter/flixerch/blob/main/src/frontend/ui/ui.c): `src/frontend/ui/ui.c`
- [UI interface](https://github.com/ultra-filter/flixerch/blob/main/src/frontend/ui/ui_interface.h): `src/frontend/ui/ui_interface.h`

### Rendering

- [Window and input](https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/window.c): `src/frontend/renderer/window.c`
- [Quad renderer](https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/quad_renderer.c): `src/frontend/renderer/quad_renderer.c`
- [Quad batching](https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/quad_batch.c): `src/frontend/renderer/quad_batch.c`
- [Image renderer](https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/image_renderer.c): `src/frontend/renderer/image_renderer.c`
- [Asset loading](https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/assets_loader.c): `src/frontend/renderer/assets_loader.c`
- [Font rendering](https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/font.c): `src/frontend/renderer/font.c`
- [Color utilities](https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/color.c): `src/frontend/renderer/color.c`
- [OpenGL loader](https://github.com/ultra-filter/flixerch/blob/main/src/frontend/renderer/glad.c): `src/frontend/renderer/glad.c`

### Web access

- [HTTP client](https://github.com/ultra-filter/flixerch/blob/main/src/backend/web/web_client.c): `src/backend/web/web_client.c`

### Core utilities

- [Math engine](https://github.com/ultra-filter/flixerch/blob/main/src/core/utils/math_engine.c): `src/core/utils/math_engine.c`
- [Image decoding](https://github.com/ultra-filter/flixerch/blob/main/src/core/decoders/stb_image.c): `src/core/decoders/stb_image.c`
- [Data structures](https://github.com/ultra-filter/flixerch/tree/main/src/core/utils/containers): `src/core/utils/containers`

### Other components

- **User**
- **libcurl**
- **Online resources**

## Connections

- User → App lifecycle: launches
- App lifecycle → Window and input: initializes and runs (evidence: `src/app.c`)
- App lifecycle → UI system: initializes and shuts down (evidence: `src/app.c`)
- UI system → UI interface: implements interface (evidence: `src/frontend/ui/ui.c`)
- UI system → Data structures: uses structures (evidence: `src/frontend/ui/ui.c`)
- UI system → Quad renderer: renders through
- UI system → Window and input: queries window
- Quad renderer → Quad batching: uses batching
- Quad renderer → Math engine: uses math
- Image renderer → Asset loading: loads assets
- Image renderer → Image decoding: decodes images
- Quad renderer → OpenGL loader: uses OpenGL
- HTTP client → libcurl: performs requests (evidence: `src/backend/web/web_client.c`)
- HTTP client → Online resources: fetches content
