Design interactive glass controls and bring them into your web project.
Demo · Install · Use · Editor · Integration
Liquid Glass UI is a skill and local editor for designing refractive buttons, switches, sliders, segmented controls, light/dark theme toggles, and other glass surfaces. Adjust a control's shape, text, icon, and material, then bring the design into an existing page while preserving its original layout and actions.
The runtime offers two paths: CSS glass for arbitrary live DOM backgrounds, and WebGL2 refraction when the application can supply the backdrop as readable pixels. CSS blur does not refract or merge arbitrary DOM content.
liquid-glass-ui-demo.mp4
18-second product demo · Download the 4K MP4
Built for coding agents including Claude Code and Codex. The simplest option is to give your agent the repository URL:
Install this skill for me: https://github.com/EVEDensity/Liquid-Glass-Skill
Or clone it into the appropriate personal skill directory. The cloned folder must contain SKILL.md directly. These commands require Git and access to GitHub; they assume the destination does not already exist.
Claude Code — macOS / Linux
mkdir -p "$HOME/.claude/skills" && git clone https://github.com/EVEDensity/Liquid-Glass-Skill.git "$HOME/.claude/skills/liquid-glass-ui"Claude Code — Windows PowerShell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills" | Out-Null; git clone https://github.com/EVEDensity/Liquid-Glass-Skill.git "$env:USERPROFILE\.claude\skills\liquid-glass-ui"Codex — macOS / Linux
mkdir -p "$HOME/.agents/skills" && git clone https://github.com/EVEDensity/Liquid-Glass-Skill.git "$HOME/.agents/skills/liquid-glass-ui"Codex — Windows PowerShell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.agents\skills" | Out-Null; git clone https://github.com/EVEDensity/Liquid-Glass-Skill.git "$env:USERPROFILE\.agents\skills\liquid-glass-ui"For a project-only Claude Code installation, use <project>/.claude/skills/liquid-glass-ui/ instead. Start a new session if the installed skill does not appear immediately.
In the project you want to edit, identify the controls and ask the agent to preserve their behavior.
Claude Code
/liquid-glass-ui Restyle the previous-month button. Open the editor so I can choose a design; keep the existing background and month navigation.
Codex
Use $liquid-glass-ui to restyle the previous-month button. Open the editor so I can choose a design; keep the existing background and month navigation.
| Request | Workflow |
|---|---|
| “Let me choose a glass design for my Save button.” | The skill opens the local editor and waits for a selected design before changing the target. |
| “Apply this copied design to my Save button.” | Paste the Copy for AI payload; the skill uses the matching runtime and preserves the original action. |
| “Use glass on the calendar's previous-month button.” | Name the target and keep its existing month navigation and background. |
The skill asks for a design when none has been selected. See SKILL.md and the integration guide for the handoff and rendering constraints.
From the cloned skill directory, run the local server and open localhost:58423/demo/. Node.js is required.
node scripts/serve.mjs- Select a control, or drag from empty canvas to select several.
- Choose a material, add or draw a shape, and adjust text, icons, and geometry in the sidebar.
- Click Copy for AI and paste the result into your agent, or use the local handoff. Use Copy offline JS for a standalone module.
You can also use the editor's button export to copy a self-contained JavaScript module. It preserves a captured scene in a separate frame and needs WebGL2 for refraction; host content security policy must permit the frame's inline script and styles. See integration recipes.
| Component | Purpose |
|---|---|
| SKILL.md | Agent workflow and design handoff |
demo/ |
Local glass editor and offline export |
assets/ |
CSS glass, WebGL2 renderer, and button runtimes |
| references/ | Integration, material, and acceptance guidance |
Node.js is needed to run the local editor; Git and GitHub access are needed for cloning. WebGL2 is required for texture refraction; CSS glass provides an alternative for live DOM backgrounds. The editor and runtime do not require the Playwright development dependency.
npm cinpm testnpm run packageRun these development commands from the repository checkout. Tests use Microsoft Edge or Playwright Chromium. See validation notes for coverage and an isolated test port. The installable archive is dist/liquid-glass-ui.zip. After extracting it, run node scripts/serve.mjs to open the editor.
New project code and documentation are MIT licensed. See third-party notices for assets and dependencies. The visual direction is inspired by Good Machines Liquid Glass Lab; this project is independently implemented and is not an official Apple implementation.