# martin65536/liquid-glass-webgl architecture

> Architecture diagram of the GitHub repository martin65536/liquid-glass-webgl, 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/martin65536/liquid-glass-webgl
- Repository: https://github.com/martin65536/liquid-glass-webgl

## Overview

Liquid Glass is a browser-based WebGL showcase that recreates iOS-style glass UI. The main workflow is opening the catalog, choosing a demo, and interacting with its canvas; the React host routes gestures and state to a renderer that composites glass effects. The catalog also exposes settings, image-backed previews, adaptive luminance, and diagnostics. The README documents renderer techniques and demo capabilities; sampled source confirms key host, renderer, and page integrations. Some catalog builders and renderer internals were not sampled, so their detailed call paths are omitted.

Main entry points: [`src/app/page.tsx`](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/app/page.tsx) (App page), [`src/components/liquid-glass/renderer/methods-render-glass-element-pass.ts`](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/methods-render-glass-element-pass.ts) (Glass element pass), [`src/components/liquid-glass/context.tsx`](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/context.tsx) (Canvas host), [`src/components/liquid-glass/renderer/index.ts`](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/index.ts) (WebGL renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_app["App page<br/>[page.tsx]"]
  node_catalog["Demo catalog<br/>[catalog.tsx]"]
  node_catalog_state["Catalog state"]
  node_wallpaper["Wallpaper preview"]
end

subgraph group_rendering["Glass rendering"]
  node_canvas_host["Canvas host<br/>[context.tsx]"]
  node_renderer["WebGL renderer<br/>[index.ts]"]
  node_render_methods["Render passes<br/>[methods-render.ts]"]
  node_glass_pass["Glass element pass"]
  node_blur["Blur pipeline<br/>[methods-blur.ts]"]
  node_fbo["Framebuffer setup<br/>[methods-fbo.ts]"]
  node_shaders["GLSL shaders<br/>[element.ts]"]
  node_geometry["Continuous corners"]
end

subgraph group_controls["Interaction and settings"]
  node_gesture_handlers["Gesture handlers"]
  node_adaptive["Adaptive luminance"]
  node_settings["Settings controls"]
  node_text_glass["Text glass controls"]
end

subgraph group_diagnostics["Diagnostics and telemetry"]
  node_perf["Performance monitor"]
  node_debug["Render diagnostics"]
  node_device_info["Device telemetry"]
end

node_visitor(("Visitor"))
node_supabase[("Supabase")]

node_visitor -->|"opens"| node_app
node_app -->|"shows"| node_catalog
node_app -->|"mounts"| node_canvas_host
node_app -->|"reads state"| node_catalog_state
node_catalog -.->|"supplies demos"| node_canvas_host
node_canvas_host -->|"creates"| node_renderer
node_canvas_host -->|"registers gestures"| node_gesture_handlers
node_gesture_handlers -->|"updates controls"| node_renderer
node_renderer -->|"dispatches rendering"| node_render_methods
node_render_methods -.->|"renders glass"| node_glass_pass
node_glass_pass -.->|"uses framebuffers"| node_fbo
node_glass_pass -.->|"applies blur"| node_blur
node_glass_pass -.->|"runs shaders"| node_shaders
node_renderer -.->|"builds corners"| node_geometry
node_app -.->|"selects image"| node_wallpaper
node_app -.->|"configures luminance"| node_adaptive
node_app -->|"shows settings"| node_settings
node_app -->|"shows controls"| node_text_glass
node_app -->|"shows monitor"| node_perf
node_app -->|"shows diagnostics"| node_debug
node_app -->|"collects telemetry"| node_device_info
node_device_info -->|"sends telemetry"| node_supabase

click node_app "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/app/page.tsx"
click node_catalog "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/catalog.tsx"
click node_catalog_state "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/app/hooks/use-catalog-state.ts"
click node_canvas_host "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/context.tsx"
click node_gesture_handlers "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/context/pointer-handlers.ts"
click node_renderer "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/index.ts"
click node_render_methods "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/methods-render.ts"
click node_glass_pass "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/methods-render-glass-element-pass.ts"
click node_blur "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/methods-blur.ts"
click node_fbo "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/methods-fbo.ts"
click node_shaders "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/shaders/element.ts"
click node_geometry "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/continuous-curve.ts"
click node_wallpaper "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/methods-wallpaper.ts"
click node_adaptive "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/app/hooks/use-adaptive-luminance.ts"
click node_settings "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/settings-import-export.tsx"
click node_text_glass "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/text-glass-advanced-panel.tsx"
click node_perf "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/perf-monitor-overlay.tsx"
click node_debug "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/capsule-sdf-debug-overlay.tsx"
click node_device_info "https://github.com/martin65536/liquid-glass-webgl/blob/main/src/lib/collect-device-info.ts"

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,node_catalog,node_catalog_state,node_wallpaper toneBlue
class node_canvas_host,node_renderer,node_render_methods,node_glass_pass,node_blur,node_fbo,node_shaders,node_geometry,node_supabase toneAmber
class node_gesture_handlers,node_adaptive,node_settings,node_text_glass toneMint
class node_perf,node_debug,node_device_info toneRose
class node_visitor toneIndigo
```

## Components

### App experience

- [App page](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Demo catalog](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/catalog.tsx): `src/components/liquid-glass/catalog.tsx`
- [Catalog state](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/app/hooks/use-catalog-state.ts): `src/app/hooks/use-catalog-state.ts`
- [Wallpaper preview](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/methods-wallpaper.ts): `src/components/liquid-glass/renderer/methods-wallpaper.ts`

### Glass rendering

- [Canvas host](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/context.tsx): `src/components/liquid-glass/context.tsx`
- [WebGL renderer](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/index.ts): `src/components/liquid-glass/renderer/index.ts`
- [Render passes](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/methods-render.ts): `src/components/liquid-glass/renderer/methods-render.ts`
- [Glass element pass](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/methods-render-glass-element-pass.ts): `src/components/liquid-glass/renderer/methods-render-glass-element-pass.ts`
- [Blur pipeline](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/methods-blur.ts): `src/components/liquid-glass/renderer/methods-blur.ts`
- [Framebuffer setup](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/methods-fbo.ts): `src/components/liquid-glass/renderer/methods-fbo.ts`
- [GLSL shaders](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/shaders/element.ts): `src/components/liquid-glass/shaders/element.ts`
- [Continuous corners](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/renderer/continuous-curve.ts): `src/components/liquid-glass/renderer/continuous-curve.ts`

### Interaction and settings

- [Gesture handlers](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/context/pointer-handlers.ts): `src/components/liquid-glass/context/pointer-handlers.ts`
- [Adaptive luminance](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/app/hooks/use-adaptive-luminance.ts): `src/app/hooks/use-adaptive-luminance.ts`
- [Settings controls](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/settings-import-export.tsx): `src/components/liquid-glass/settings-import-export.tsx`
- [Text glass controls](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/text-glass-advanced-panel.tsx): `src/components/liquid-glass/text-glass-advanced-panel.tsx`

### Diagnostics and telemetry

- [Performance monitor](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/perf-monitor-overlay.tsx): `src/components/liquid-glass/perf-monitor-overlay.tsx`
- [Render diagnostics](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/components/liquid-glass/capsule-sdf-debug-overlay.tsx): `src/components/liquid-glass/capsule-sdf-debug-overlay.tsx`
- [Device telemetry](https://github.com/martin65536/liquid-glass-webgl/blob/main/src/lib/collect-device-info.ts): `src/lib/collect-device-info.ts`

### Other components

- **Visitor**
- **Supabase**

## Connections

- Visitor → App page: opens (evidence: `README.md`)
- App page → Demo catalog: shows (evidence: `src/app/page.tsx`)
- App page → Canvas host: mounts (evidence: `src/app/page.tsx`)
- App page → Catalog state: reads state (evidence: `src/app/page.tsx`)
- Demo catalog → Canvas host: supplies demos (evidence: `README.md`)
- Canvas host → WebGL renderer: creates (evidence: `src/components/liquid-glass/context.tsx`)
- Canvas host → Gesture handlers: registers gestures (evidence: `src/components/liquid-glass/context.tsx`)
- Gesture handlers → WebGL renderer: updates controls (evidence: `src/components/liquid-glass/context/pointer-handlers.ts`)
- WebGL renderer → Render passes: dispatches rendering (evidence: `src/components/liquid-glass/renderer/index.ts`)
- Render passes → Glass element pass: renders glass (evidence: `README.md`)
- Glass element pass → Framebuffer setup: uses framebuffers (evidence: `README.md`)
- Glass element pass → Blur pipeline: applies blur (evidence: `README.md`)
- Glass element pass → GLSL shaders: runs shaders (evidence: `README.md`)
- WebGL renderer → Continuous corners: builds corners (evidence: `README.md`)
- App page → Wallpaper preview: selects image (evidence: `README.md`)
- App page → Adaptive luminance: configures luminance (evidence: `README.md`)
- App page → Settings controls: shows settings (evidence: `src/app/page.tsx`)
- App page → Text glass controls: shows controls (evidence: `src/app/page.tsx`)
- App page → Performance monitor: shows monitor (evidence: `src/app/page.tsx`)
- App page → Render diagnostics: shows diagnostics (evidence: `src/app/page.tsx`)
- App page → Device telemetry: collects telemetry (evidence: `src/app/page.tsx`)
- Device telemetry → Supabase: sends telemetry (evidence: `src/lib/collect-device-info.ts`)
