# akseolabs-seo/cinematic-ui architecture

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

- Interactive diagram: https://gitdiagram.com/akseolabs-seo/cinematic-ui
- Repository: https://github.com/akseolabs-seo/cinematic-ui

## Overview

Cinematic UI is an agent skill for directing website and app creation through a film-production workflow, with a browser kit and tools for asset work, rendering, and screening. The README documents the production stages and several feature relationships; source excerpts and the SOURCE INDEX support the kit and tooling links shown. Some reference-guided stages and kit capabilities are documented but their implementation was not sampled, so those nodes use exact existing paths and unsupported connections are omitted.

Main entry points: [`scripts/lib.mjs`](https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/lib.mjs) (Browser utilities), [`scripts/screening.mjs`](https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/screening.mjs) (Visual screening), [`references/directors.md`](https://github.com/akseolabs-seo/cinematic-ui/blob/master/references/directors.md) (Director casting), [`SKILL.md`](https://github.com/akseolabs-seo/cinematic-ui/blob/master/SKILL.md) (Asset call)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_production["Production workflow"]
  node_skill["Director skill<br/>[SKILL.md]"]
  node_development["Development<br/>[SKILL.md]"]
  node_director["Director casting<br/>[directors.md]"]
  node_medium["Medium choice<br/>[looks.md]"]
  node_asset_call["Asset call<br/>[SKILL.md]"]
  node_screenplay["Screenplay<br/>[SKILL.md]"]
  node_storyboard["Storyboard<br/>[storyboard.md]"]
  node_animatic["Animatic<br/>[SKILL.md]"]
  node_photography["Principal photography<br/>[art-direction.md]"]
  node_delivery["Delivery report<br/>[SKILL.md]"]
end

subgraph group_craft["Film craft references"]
  node_film_research["Film research<br/>[film-research.md]"]
  node_art_direction["Art direction<br/>[art-direction.md]"]
end

subgraph group_kit["Cinematic UI kit"]
  node_app_mode["App mode<br/>[app.js]"]
  node_fixtures["Screen fixtures<br/>[fixtures.js]"]
  node_visual_looks["Visual media<br/>[looks.js]"]
  node_grade["DOM grading<br/>[grade.js]"]
  node_type_motion["Type motion<br/>[type-fx.js]"]
  node_three_stage["Three.js stage<br/>[stage.js]"]
  node_props["Procedural props<br/>[props.js]"]
  node_reel["Reel playback<br/>[reel.js]"]
end

subgraph group_assets["Asset tools"]
  node_footage["Footage search<br/>[find-footage.mjs]"]
  node_image_gen["Image generation<br/>[generate-image.mjs]"]
  node_grade_measure["Still grade analysis"]
end

subgraph group_review["Review and delivery"]
  node_screening["Visual screening<br/>[screening.mjs]"]
  node_app_screening["App screening<br/>[app-screening.mjs]"]
  node_copy_check["Copy check<br/>[copy-check.mjs]"]
  node_render["Film rendering<br/>[render-film.mjs]"]
  node_shared_tools["Browser utilities<br/>[lib.mjs]"]
end

node_agent(("AI agent"))

node_agent -->|"invokes"| node_skill
node_skill -->|"begins with"| node_development
node_development -->|"casts"| node_director
node_director -->|"chooses"| node_medium
node_medium -->|"informs"| node_asset_call
node_asset_call -->|"continues to"| node_screenplay
node_screenplay -->|"continues to"| node_storyboard
node_storyboard -->|"continues to"| node_animatic
node_animatic -->|"continues to"| node_photography
node_photography -->|"continues to"| node_screening
node_screening -->|"informs"| node_delivery
node_director -->|"researches films"| node_film_research
node_photography -->|"directs visual design"| node_art_direction
node_app_mode -->|"freezes time"| node_fixtures
node_props -->|"uses seeded helper"| node_three_stage
node_grade_measure -->|"produces grade for"| node_grade
node_screening -->|"checks grade"| node_grade
node_screening -->|"uses"| node_shared_tools
node_app_screening -->|"uses"| node_shared_tools
node_render -->|"uses"| node_shared_tools
node_grade_measure -->|"uses"| node_shared_tools
node_copy_check -->|"uses"| node_shared_tools
node_footage -->|"uses"| node_shared_tools
node_screening -.->|"reviews before delivery"| node_render
node_asset_call -.->|"may generate"| node_image_gen

click node_skill "https://github.com/akseolabs-seo/cinematic-ui/blob/master/SKILL.md"
click node_development "https://github.com/akseolabs-seo/cinematic-ui/blob/master/SKILL.md"
click node_director "https://github.com/akseolabs-seo/cinematic-ui/blob/master/references/directors.md"
click node_medium "https://github.com/akseolabs-seo/cinematic-ui/blob/master/references/looks.md"
click node_asset_call "https://github.com/akseolabs-seo/cinematic-ui/blob/master/SKILL.md"
click node_screenplay "https://github.com/akseolabs-seo/cinematic-ui/blob/master/SKILL.md"
click node_storyboard "https://github.com/akseolabs-seo/cinematic-ui/blob/master/references/storyboard.md"
click node_animatic "https://github.com/akseolabs-seo/cinematic-ui/blob/master/SKILL.md"
click node_photography "https://github.com/akseolabs-seo/cinematic-ui/blob/master/references/art-direction.md"
click node_film_research "https://github.com/akseolabs-seo/cinematic-ui/blob/master/references/film-research.md"
click node_art_direction "https://github.com/akseolabs-seo/cinematic-ui/blob/master/references/art-direction.md"
click node_app_mode "https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/app.js"
click node_fixtures "https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/fixtures.js"
click node_visual_looks "https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/looks.js"
click node_grade "https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/grade.js"
click node_type_motion "https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/type-fx.js"
click node_three_stage "https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/stage.js"
click node_props "https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/props.js"
click node_reel "https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/reel.js"
click node_footage "https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/find-footage.mjs"
click node_image_gen "https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/generate-image.mjs"
click node_grade_measure "https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/grade-from-stills.mjs"
click node_screening "https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/screening.mjs"
click node_app_screening "https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/app-screening.mjs"
click node_copy_check "https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/copy-check.mjs"
click node_render "https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/render-film.mjs"
click node_shared_tools "https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/lib.mjs"
click node_delivery "https://github.com/akseolabs-seo/cinematic-ui/blob/master/SKILL.md"

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_skill,node_development,node_director,node_medium,node_asset_call,node_screenplay,node_storyboard,node_animatic,node_photography,node_delivery toneBlue
class node_film_research,node_art_direction toneAmber
class node_app_mode,node_fixtures,node_visual_looks,node_grade,node_type_motion,node_three_stage,node_props,node_reel toneMint
class node_footage,node_image_gen,node_grade_measure toneRose
class node_screening,node_app_screening,node_copy_check,node_render,node_shared_tools,node_agent toneIndigo
```

## Components

### Production workflow

- [Director skill](https://github.com/akseolabs-seo/cinematic-ui/blob/master/SKILL.md): `SKILL.md`
- [Development](https://github.com/akseolabs-seo/cinematic-ui/blob/master/SKILL.md): `SKILL.md`
- [Director casting](https://github.com/akseolabs-seo/cinematic-ui/blob/master/references/directors.md): `references/directors.md`
- [Medium choice](https://github.com/akseolabs-seo/cinematic-ui/blob/master/references/looks.md): `references/looks.md`
- [Asset call](https://github.com/akseolabs-seo/cinematic-ui/blob/master/SKILL.md): `SKILL.md`
- [Screenplay](https://github.com/akseolabs-seo/cinematic-ui/blob/master/SKILL.md): `SKILL.md`
- [Storyboard](https://github.com/akseolabs-seo/cinematic-ui/blob/master/references/storyboard.md): `references/storyboard.md`
- [Animatic](https://github.com/akseolabs-seo/cinematic-ui/blob/master/SKILL.md): `SKILL.md`
- [Principal photography](https://github.com/akseolabs-seo/cinematic-ui/blob/master/references/art-direction.md): `references/art-direction.md`
- [Delivery report](https://github.com/akseolabs-seo/cinematic-ui/blob/master/SKILL.md): `SKILL.md`

### Film craft references

- [Film research](https://github.com/akseolabs-seo/cinematic-ui/blob/master/references/film-research.md): `references/film-research.md`
- [Art direction](https://github.com/akseolabs-seo/cinematic-ui/blob/master/references/art-direction.md): `references/art-direction.md`

### Cinematic UI kit

- [App mode](https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/app.js): `kit/app.js`
- [Screen fixtures](https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/fixtures.js): `kit/fixtures.js`
- [Visual media](https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/looks.js): `kit/looks.js`
- [DOM grading](https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/grade.js): `kit/grade.js`
- [Type motion](https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/type-fx.js): `kit/type-fx.js`
- [Three.js stage](https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/stage.js): `kit/stage.js`
- [Procedural props](https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/props.js): `kit/props.js`
- [Reel playback](https://github.com/akseolabs-seo/cinematic-ui/blob/master/kit/reel.js): `kit/reel.js`

### Asset tools

- [Footage search](https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/find-footage.mjs): `scripts/find-footage.mjs`
- [Image generation](https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/generate-image.mjs): `scripts/generate-image.mjs`
- [Still grade analysis](https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/grade-from-stills.mjs): `scripts/grade-from-stills.mjs`

### Review and delivery

- [Visual screening](https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/screening.mjs): `scripts/screening.mjs`
- [App screening](https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/app-screening.mjs): `scripts/app-screening.mjs`
- [Copy check](https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/copy-check.mjs): `scripts/copy-check.mjs`
- [Film rendering](https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/render-film.mjs): `scripts/render-film.mjs`
- [Browser utilities](https://github.com/akseolabs-seo/cinematic-ui/blob/master/scripts/lib.mjs): `scripts/lib.mjs`

### Other components

- **AI agent**

## Connections

- AI agent → Director skill: invokes (evidence: `README.md`)
- Director skill → Development: begins with (evidence: `README.md`)
- Development → Director casting: casts (evidence: `README.md`)
- Director casting → Medium choice: chooses (evidence: `README.md`)
- Medium choice → Asset call: informs (evidence: `README.md`)
- Asset call → Screenplay: continues to (evidence: `README.md`)
- Screenplay → Storyboard: continues to (evidence: `README.md`)
- Storyboard → Animatic: continues to (evidence: `README.md`)
- Animatic → Principal photography: continues to (evidence: `README.md`)
- Principal photography → Visual screening: continues to (evidence: `README.md`)
- Visual screening → Delivery report: informs (evidence: `README.md`)
- Director casting → Film research: researches films (evidence: `README.md`)
- Principal photography → Art direction: directs visual design (evidence: `README.md`)
- App mode → Screen fixtures: freezes time (evidence: `kit/app.js`)
- Procedural props → Three.js stage: uses seeded helper (evidence: `kit/props.js`)
- Still grade analysis → DOM grading: produces grade for (evidence: `README.md`)
- Visual screening → DOM grading: checks grade (evidence: `README.md`)
- Visual screening → Browser utilities: uses (evidence: `scripts/screening.mjs`)
- App screening → Browser utilities: uses (evidence: `scripts/app-screening.mjs`)
- Film rendering → Browser utilities: uses (evidence: `scripts/render-film.mjs`)
- Still grade analysis → Browser utilities: uses (evidence: `scripts/grade-from-stills.mjs`)
- Copy check → Browser utilities: uses (evidence: `scripts/copy-check.mjs`)
- Footage search → Browser utilities: uses (evidence: `scripts/find-footage.mjs`)
- Visual screening → Film rendering: reviews before delivery
- Asset call → Image generation: may generate (evidence: `README.md`)
