# engineer12-garko/litecome architecture

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

## Overview

LiteCompress is a static, privacy-first video-compression web app. Users select or drop videos, choose a compression preset, and run jobs in a queue; the app returns downloadable, previewable MP4 output. For long videos, it can checkpoint segments for recovery and assemble them when complete. The graph separates intake, orchestration, encoding, and local state, with preview and offline caching as supporting capabilities. App orchestration and the worker are shown from excerpts; some UI and recovery details are documented or referenced but not fully sampled.

Main entry points: [`js/app.js`](https://github.com/engineer12-garko/litecome/blob/main/js/app.js) (App orchestration), [`js/file-manager.js`](https://github.com/engineer12-garko/litecome/blob/main/js/file-manager.js) (File manager), [`js/compression-worker.js`](https://github.com/engineer12-garko/litecome/blob/main/js/compression-worker.js) (Compression worker), [`index.html`](https://github.com/engineer12-garko/litecome/blob/main/index.html) (File selection UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Video intake"]
  node_file_ui["File selection UI<br/>[index.html]"]
  node_file_manager["File manager<br/>[file-manager.js]"]
end

subgraph group_workflow["Job workflow"]
  node_app["App orchestration<br/>[app.js]"]
  node_queue["Job queue<br/>[job-queue.js]"]
  node_presets["Compression presets<br/>[presets.js]"]
  node_preview["Preview manager<br/>[preview.js]"]
  node_utilities["File utilities<br/>[utils.js]"]
end

subgraph group_encoding["Compression"]
  node_engine["Compression engine"]
  node_worker["Compression worker"]
  node_ffmpeg["FFmpeg.wasm"]
end

subgraph group_state["Local state"]
  node_job_store[("Job and history store")]
  node_checkpoint_store[("Segment checkpoint store")]
  node_service_worker["Offline asset cache<br/>[sw.js]"]
end

node_user(("User"))

node_user -->|"selects videos"| node_file_ui
node_file_ui -->|"provides files"| node_file_manager
node_file_manager -->|"filters files"| node_utilities
node_file_manager -->|"passes accepted files"| node_app
node_app -->|"runs jobs"| node_queue
node_app -->|"selects settings"| node_presets
node_app -->|"requests compression"| node_engine
node_engine -->|"dispatches tasks"| node_worker
node_worker -->|"encodes and assembles"| node_ffmpeg
node_app -->|"saves jobs and history"| node_job_store
node_app -->|"reads and writes segments"| node_checkpoint_store
node_app -->|"manages previews"| node_preview
node_app -->|"formats output"| node_utilities
node_service_worker -->|"caches app assets"| node_file_ui
node_worker -->|"reads segments for assembly"| node_checkpoint_store

click node_file_ui "https://github.com/engineer12-garko/litecome/blob/main/index.html"
click node_file_manager "https://github.com/engineer12-garko/litecome/blob/main/js/file-manager.js"
click node_app "https://github.com/engineer12-garko/litecome/blob/main/js/app.js"
click node_queue "https://github.com/engineer12-garko/litecome/blob/main/js/job-queue.js"
click node_presets "https://github.com/engineer12-garko/litecome/blob/main/js/presets.js"
click node_preview "https://github.com/engineer12-garko/litecome/blob/main/js/preview.js"
click node_utilities "https://github.com/engineer12-garko/litecome/blob/main/js/utils.js"
click node_engine "https://github.com/engineer12-garko/litecome/blob/main/js/compression-engine.js"
click node_worker "https://github.com/engineer12-garko/litecome/blob/main/js/compression-worker.js"
click node_job_store "https://github.com/engineer12-garko/litecome/blob/main/js/persistence-store.js"
click node_checkpoint_store "https://github.com/engineer12-garko/litecome/blob/main/js/checkpoint-store.js"
click node_service_worker "https://github.com/engineer12-garko/litecome/blob/main/sw.js"

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_file_ui,node_file_manager,node_user toneBlue
class node_app,node_queue,node_presets,node_preview,node_utilities toneAmber
class node_engine,node_worker,node_ffmpeg toneMint
class node_job_store,node_checkpoint_store,node_service_worker toneRose
```

## Components

### Video intake

- [File selection UI](https://github.com/engineer12-garko/litecome/blob/main/index.html): `index.html`
- [File manager](https://github.com/engineer12-garko/litecome/blob/main/js/file-manager.js): `js/file-manager.js`

### Job workflow

- [App orchestration](https://github.com/engineer12-garko/litecome/blob/main/js/app.js): `js/app.js`
- [Job queue](https://github.com/engineer12-garko/litecome/blob/main/js/job-queue.js): `js/job-queue.js`
- [Compression presets](https://github.com/engineer12-garko/litecome/blob/main/js/presets.js): `js/presets.js`
- [Preview manager](https://github.com/engineer12-garko/litecome/blob/main/js/preview.js): `js/preview.js`
- [File utilities](https://github.com/engineer12-garko/litecome/blob/main/js/utils.js): `js/utils.js`

### Compression

- [Compression engine](https://github.com/engineer12-garko/litecome/blob/main/js/compression-engine.js): `js/compression-engine.js`
- [Compression worker](https://github.com/engineer12-garko/litecome/blob/main/js/compression-worker.js): `js/compression-worker.js`
- **FFmpeg.wasm**

### Local state

- [Job and history store](https://github.com/engineer12-garko/litecome/blob/main/js/persistence-store.js): `js/persistence-store.js`
- [Segment checkpoint store](https://github.com/engineer12-garko/litecome/blob/main/js/checkpoint-store.js): `js/checkpoint-store.js`
- [Offline asset cache](https://github.com/engineer12-garko/litecome/blob/main/sw.js): `sw.js`

### Other components

- **User**

## Connections

- User → File selection UI: selects videos
- File selection UI → File manager: provides files (evidence: `js/file-manager.js`)
- File manager → File utilities: filters files (evidence: `js/file-manager.js`)
- File manager → App orchestration: passes accepted files (evidence: `js/file-manager.js`)
- App orchestration → Job queue: runs jobs (evidence: `js/app.js`)
- App orchestration → Compression presets: selects settings (evidence: `js/app.js`)
- App orchestration → Compression engine: requests compression (evidence: `js/app.js`)
- Compression engine → Compression worker: dispatches tasks (evidence: `js/compression-engine.js`)
- Compression worker → FFmpeg.wasm: encodes and assembles (evidence: `js/compression-worker.js`)
- App orchestration → Job and history store: saves jobs and history (evidence: `js/app.js`)
- App orchestration → Segment checkpoint store: reads and writes segments (evidence: `js/app.js`)
- App orchestration → Preview manager: manages previews (evidence: `js/app.js`)
- App orchestration → File utilities: formats output (evidence: `js/app.js`)
- Offline asset cache → File selection UI: caches app assets (evidence: `sw.js`)
- Compression worker → Segment checkpoint store: reads segments for assembly (evidence: `js/compression-worker.js`)
