How martin65536/liquid-glass-webgl works
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: page.tsx App page · methods-render-glass-element-pass.ts Glass element pass · context.tsx Canvas host · index.ts WebGL renderer
Components 21
App experience
- App page
src/app/page.tsx - Demo catalog
src/components/liquid-glass/catalog.tsx - Catalog state
src/app/hooks/use-catalog-state.ts - Wallpaper preview
src/components/liquid-glass/renderer/methods-wallpaper.ts
Glass rendering
- Canvas host
src/components/liquid-glass/context.tsx - WebGL renderer
src/components/liquid-glass/renderer/index.ts - Render passes
src/components/liquid-glass/renderer/methods-render.ts - Glass element pass
src/components/liquid-glass/renderer/methods-render-glass-element-pass.ts - Blur pipeline
src/components/liquid-glass/renderer/methods-blur.ts - Framebuffer setup
src/components/liquid-glass/renderer/methods-fbo.ts - GLSL shaders
src/components/liquid-glass/shaders/element.ts - Continuous corners
src/components/liquid-glass/renderer/continuous-curve.ts
Interaction and settings
- Gesture handlers
src/components/liquid-glass/context/pointer-handlers.ts - Adaptive luminance
src/app/hooks/use-adaptive-luminance.ts - Settings controls
src/components/liquid-glass/settings-import-export.tsx - Text glass controls
src/components/liquid-glass/text-glass-advanced-panel.tsx
Diagnostics and telemetry
- Performance monitor
src/components/liquid-glass/perf-monitor-overlay.tsx - Render diagnostics
src/components/liquid-glass/capsule-sdf-debug-overlay.tsx - Device telemetry
src/lib/collect-device-info.ts
Other components
- Visitor
- Supabase
Connections 22
- Visitor → App page: opens
README.md - App page → Demo catalog: shows
src/app/page.tsx - App page → Canvas host: mounts
src/app/page.tsx - App page → Catalog state: reads state
src/app/page.tsx - Demo catalog → Canvas host: supplies demos
README.md - Canvas host → WebGL renderer: creates
src/components/liquid-glass/context.tsx - Canvas host → Gesture handlers: registers gestures
src/components/liquid-glass/context.tsx - Gesture handlers → WebGL renderer: updates controls
src/components/liquid-glass/context/pointer-handlers.ts - WebGL renderer → Render passes: dispatches rendering
src/components/liquid-glass/renderer/index.ts - Render passes → Glass element pass: renders glass
README.md - Glass element pass → Framebuffer setup: uses framebuffers
README.md - Glass element pass → Blur pipeline: applies blur
README.md - Glass element pass → GLSL shaders: runs shaders
README.md - WebGL renderer → Continuous corners: builds corners
README.md - App page → Wallpaper preview: selects image
README.md - App page → Adaptive luminance: configures luminance
README.md - App page → Settings controls: shows settings
src/app/page.tsx - App page → Text glass controls: shows controls
src/app/page.tsx - App page → Performance monitor: shows monitor
src/app/page.tsx - App page → Render diagnostics: shows diagnostics
src/app/page.tsx - App page → Device telemetry: collects telemetry
src/app/page.tsx - Device telemetry → Supabase: sends telemetry
src/lib/collect-device-info.ts