v0.1 public beta early access on GitHub
Home / Components / glass

Liquid GlassiOS

iOS 26 liquid-glass surface — real glass via expo-glass-effect (Expo Go) or @callstack/liquid-glass (dev builds), SVG refraction + specular rim on web, frosted fallback elsewhere; GlassContainer melts adjacent panes into one blob

$ npx lumioui add glass
import { useGlass, Glass, GlassContainer } from "@/components/ui/glass/glass";
Parts: useGlass · Glass · GlassContainer
Props15
Glass
effect? "clear" | "regular" | "none" 'regular' = standard glass blur, 'clear' = more transparent, 'none' = fallback everywhere.
tintColor? ColorValue Tint overlaid on the glass (native); also tints the fallback fill.
interactive? boolean iOS 26 press interaction (fluid squish + glow).
bend? number Edge refraction strength 0–1 — how far the lens bends the backdrop. Web only; native glass always refracts per Apple.
frost? number Diffusion 0–1 — extra backdrop blur behind the glass.
sheen? number Diagonal sheen intensity 0–1. Web only.
dispersion? boolean Chromatic fringe at the rim. Web only.
curvature? "dome" | "edge" Lens curvature — 'dome' warps the whole surface (lens look), 'edge' concentrates refraction at the rim. Web only.
className? string
children? React.ReactNode
GlassContainer
spacing? number How close panes must sit before they merge into one blob — maps to the native containers' `spacing`.
merged? boolean Merge children into a single glass slab on web (default true). Native unions always merge per UIKit.
effect? "clear" | "regular" Glass effect for the merged web slab.
className? string
children? React.ReactNode
Liquid Glassglass.tsx
glass/glass.tsx open

iOS 26 liquid-glass surface — real glass via expo-glass-effect (Expo Go) or @callstack/liquid-glass (dev builds), SVG refraction + specular rim on web, frosted fallback elsewhere; GlassContainer melts adjacent panes into one blob