# saadnaeem453/coffee-website architecture

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

- Interactive diagram: https://gitdiagram.com/saadnaeem453/coffee-website
- Repository: https://github.com/saadnaeem453/coffee-website

## Overview

This is a small browser-based cinematic player: it loads a frame manifest and image sequence, then renders available frames to a canvas while responding to scroll-driven playback. The sampled code also shows progressive loading, loader updates, and responsive Retina-aware sizing. The scroll-trigger setup is visible, but its callback is omitted from the excerpt, so the exact scroll-to-frame relationship is not asserted.

Main entry points: [`cinematic-player.js`](https://github.com/saadnaeem453/coffee-website/blob/main/cinematic-player.js) (Cinematic player), [`assets/frames/manifest.json`](https://github.com/saadnaeem453/coffee-website/blob/main/assets/frames/manifest.json) (Frame manifest), [`assets/frames`](https://github.com/saadnaeem453/coffee-website/tree/main/assets/frames) (Frame images)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_playback["Playback"]
  node_player["Cinematic player"]
  node_scrolltrigger["ScrollTrigger setup"]
end

subgraph group_assets["Frame Assets"]
  node_manifest["Frame manifest<br/>[manifest.json]"]
  node_frames["Frame images"]
end

subgraph group_display["Display"]
  node_renderer["Canvas renderer"]
  node_loader["Loading indicator"]
end

node_visitor(("Page visitor"))
node_scroll(("Scroll position"))

node_player -->|"fetches"| node_manifest
node_player -->|"loads images"| node_frames
node_player -->|"draws frames"| node_renderer
node_player -->|"updates progress"| node_loader
node_player -->|"sets up"| node_scrolltrigger
node_visitor -->|"scrolls"| node_scroll
node_scroll -.->|"drives playback"| node_player

click node_player "https://github.com/saadnaeem453/coffee-website/blob/main/cinematic-player.js"
click node_scrolltrigger "https://github.com/saadnaeem453/coffee-website/blob/main/cinematic-player.js"
click node_manifest "https://github.com/saadnaeem453/coffee-website/blob/main/assets/frames/manifest.json"
click node_frames "https://github.com/saadnaeem453/coffee-website/tree/main/assets/frames"
click node_renderer "https://github.com/saadnaeem453/coffee-website/blob/main/cinematic-player.js"
click node_loader "https://github.com/saadnaeem453/coffee-website/blob/main/cinematic-player.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_player,node_scrolltrigger toneBlue
class node_manifest,node_frames toneAmber
class node_renderer,node_loader toneMint
class node_visitor,node_scroll toneIndigo
```

## Components

### Playback

- [Cinematic player](https://github.com/saadnaeem453/coffee-website/blob/main/cinematic-player.js): `cinematic-player.js`
- [ScrollTrigger setup](https://github.com/saadnaeem453/coffee-website/blob/main/cinematic-player.js): `cinematic-player.js`

### Frame Assets

- [Frame manifest](https://github.com/saadnaeem453/coffee-website/blob/main/assets/frames/manifest.json): `assets/frames/manifest.json`
- [Frame images](https://github.com/saadnaeem453/coffee-website/tree/main/assets/frames): `assets/frames`

### Display

- [Canvas renderer](https://github.com/saadnaeem453/coffee-website/blob/main/cinematic-player.js): `cinematic-player.js`
- [Loading indicator](https://github.com/saadnaeem453/coffee-website/blob/main/cinematic-player.js): `cinematic-player.js`

### Other components

- **Page visitor**
- **Scroll position**

## Connections

- Cinematic player → Frame manifest: fetches (evidence: `cinematic-player.js`)
- Cinematic player → Frame images: loads images (evidence: `cinematic-player.js`)
- Cinematic player → Canvas renderer: draws frames (evidence: `cinematic-player.js`)
- Cinematic player → Loading indicator: updates progress (evidence: `cinematic-player.js`)
- Cinematic player → ScrollTrigger setup: sets up (evidence: `cinematic-player.js`)
- Page visitor → Scroll position: scrolls
- Scroll position → Cinematic player: drives playback
