Not in the top 1,000 by GitHub stars
gentpan/liquidglass
Real liquid glass for the web: refractive web components that render the same in Chrome, Safari and Firefox, plus an AI agent skill.
History
Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.
View weekly changes
skill/liquid-glass-web/SKILL.md
Week of Nov 2, 2026 · +0 / −0 lines
Before Network or broad shell → After Network or broad shell
068ad226f53e → 068ad226f53e
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Network or broad shell
First observation → 068ad226f53e
No earlier version was observed for comparison.
Heat
3.3- Star growth, last 7 daysNot available
- Star growth, last 24 hoursNot available
- Rank movement, last 7 daysNot available
- Commits, last 30 daysNot available
- Accounts asking about it through MCP, last 7 daysNot available
- Hot votes this weekNot available
Heat never changes the order by stars, and sponsorship never touches it. How heat works
Stars over time
30-day change not yet available: not enough history.
Individual skills in this repository
- liquid-glass-web
skill/liquid-glass-web
How it works
liquid-glass-web
When your agent uses it
Build refractive "liquid glass" UI for the web (Apple Liquid Glass style) that renders the same in Chrome, Safari/iOS and Firefox — SVG feDisplacementMap applied through CSS filter to the content itself, runtime displacement maps, chromatic fringe and rim highlights, press/squish springs, WebKit-specific fixes, WebGL for video. Ships the liquidglass.dev web components (switch, slider, segmented, button, panel, navbar, menu bar, toast, dock, lens), the zero-dependency engine, a reference page and a three-engine screenshot script. Use whenever a web or front-end task (HTML/CSS/React/Vue/Svelte) asks for liquid glass, glass refraction, a glass lens or magnifier, glassmorphism that should actually bend light, or Apple-style glass switches, sliders, segmented controls, tab indicators, cards, navbars, menus, toasts or docks — and when a backdrop-filter glass effect does not show up in Safari or Firefox. Not for native SwiftUI/UIKit apps (use the system glassEffect there).
What it loads into context
Frontmatter
227 tokensAlways available to the agent
SKILL.md
3,128 tokensWhen the skill is activated
Reference documents
8,400 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- How it works
- Step 1 — pick the path
- Step 2 — use the bundled engine
- Step 3 — make it read as liquid glass
- Step 4 — rules that break an engine when ignored
- Accessibility and fallbacks
- Step 5 — verify before handing over
- Files
Scripts executed separately
assets/components.jsassets/glass-webgl.jsassets/liquid-glass.jsscripts/chrome-shot.mjsscripts/serve.pyscripts/shoot.sh
Files
SKILL.mdcore12,279 bytesSKILL.mdcore12,279 bytesagents/openai.yamlasset296 bytesassets/components.jsruns56,834 bytesassets/demo.htmlasset33,954 bytesassets/glass-webgl.jsruns7,209 bytesassets/liquid-glass.jsruns24,816 bytesreferences/browser-quirks.mddoc7,906 bytesreferences/components.mddoc4,906 bytesreferences/optics.mddoc5,347 bytesreferences/patterns.mddoc12,356 bytesscripts/chrome-shot.mjsruns4,417 bytesscripts/serve.pyruns2,392 bytesscripts/shoot.shruns2,113 bytesscripts/snap-webkit.swiftasset2,470 bytes
Read SKILL.md
# Liquid glass for the web
Goal: glass that really bends light, like Apple's Liquid Glass, rather than a blur — and looks the same in Chromium, WebKit (Safari and every iOS browser) and Gecko (Firefox). The approach follows Aave Labs' [Building Glass for the Web](https://aave.com/design/building-glass-for-the-web); the bundled code is an independent implementation, verified screenshot-by-screenshot in all three engines. Live site and docs: https://liquidglass.dev.
## How it works
1. **Refraction goes on `filter: url(#id)`, not `backdrop-filter`.** `backdrop-filter: url()` only renders in Chromium. A plain `filter` referencing an SVG filter works everywhere, but it bends the element's *own* pixels — so whatever should be bent must be inside the glass element: the real content, or a decorative copy of it.
2. **The displacement map is generated at runtime from the lens shape.** Red/green = horizontal/vertical bend, blue = rim highlight, alpha = lens coverage, neutral grey 128 outside the lens. Pixels outside the lens pass through untouched, so text stays selectable and links clickable.
3. **Moving is cheap, reshaping regenerates.** Moving a lens only changes filter sub-region coordinates; the map is redrawn only when shape or optics change (cached, only a quarter computed).
4. **Surfaces without live DOM use WebGL with the same map.** Safari never runs SVG filters on a playing `<video>`; canvas content has no DOM either.
## Step 1 — pick the path
**Fastest: the ready-made web components.** If the project can load an ES module, use `assets/components.js` (copy it next to `assets/liquid-glass.js`, or load `https://liquidglass.dev/lib/components.js`). Elements: `lg-switch`, `lg-slider`, `lg-segmented`, `lg-button`, `lg-panel`, `lg-navbar`, `lg-menubar` + `lg-menu`, `toast()`, `lg-dock`, `lg-lens`. Usage, attributes and theming variables: [references/components.md](references/components.md).View the complete source on GitHubSkills included
- liquid-glass-web
Repository facts
- License
- MIT
- Created
- Sep 19, 2026
- Last pushed
- Oct 30, 2026
- Forks
- 0
- Open issues
- 0
- Project activity
- Active
Before you install
Network or broad shellAutomated signals, not a guarantee
Checked Nov 7, 2026
Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.
Show 1 note
skill/liquid-glass-web/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzed
- No broad tool permissions
- No dangerous shell commands
- 17 network referencesin 7 files: liquid-glass-web/assets/components.js:2 liquid-glass-web/assets/demo.html:274 liquid-glass-web/scripts/chrome-shot.mjs:40 and 4 more
- No hidden or obfuscated text
- No instruction overrides
- 6 executable scriptsin 6 files: liquid-glass-web/assets/components.js:1 liquid-glass-web/assets/glass-webgl.js:1 liquid-glass-web/assets/liquid-glass.js:1 and 3 more
- No access to secrets
- No requests to vote in Hot
Show all 23 signals by file
skill/liquid-glass-web/SKILL.md
- Network accessline 8
Goal: glass that really bends light, like Apple's Liquid Glass, rather than a blur — and looks the same in Chromium, WebKit (Safari and every iOS browser) and Gecko (Firefox). The approach follows Aave Labs' [Building Glass for the Web](htt - Network accessline 19
**Fastest: the ready-made web components.** If the project can load an ES module, use `assets/components.js` (copy it next to `assets/liquid-glass.js`, or load `https://liquidglass.dev/lib/components.js`). Elements: `lg-switch`, `lg-slider`
skill/liquid-glass-web/assets/components.js
- Executable scriptline 1
Executable file - Network accessline 2
* components.js v1.0.0 — Liquid Glass web components. * * <script type="module" src="https://liquidglass.dev/lib/components.js"></script> - Network accessline 3
* * <script type="module" src="https://liquidglass.dev/lib/components.js"></script> * <lg-switch checked>Wi-Fi</lg-switch> - Network accessline 4
* <script type="module" src="https://liquidglass.dev/lib/components.js"></script>
skill/liquid-glass-web/assets/demo.html
- Network accessline 274
/* ---------------------------------------------------------------- art (content to refract) */ const ART = `data:image/svg+xml,${encodeURIComponent(` <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 520" preserveAspectRatio="xMidY - Network accessline 275
const ART = `data:image/svg+xml,${encodeURIComponent(` <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 520" preserveAspectRatio="xMidYMid slice"> <defs> - Network accessline 276
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 520" preserveAspectRatio="xMidYMid slice">
skill/liquid-glass-web/assets/glass-webgl.js
- Executable scriptline 1
Executable file
skill/liquid-glass-web/assets/liquid-glass.js
skill/liquid-glass-web/references/components.md
- Network accessline 3
`assets/components.js` (also hosted at `https://liquidglass.dev/lib/components.js`) defines light-DOM custom elements on top of the engine. They need `liquid-glass.js` in the same directory. Styles are injected once; theme them with the `-- - Network accessline 10
<script type="module" src="https://liquidglass.dev/lib/components.js"></script>
skill/liquid-glass-web/scripts/chrome-shot.mjs
- Executable scriptline 1
#!/usr/bin/env node - Network accessline 40
for (let i = 0; i < 100 && !ws; i++) { try { const targets = await (await fetch(`http://127.0.0.1:${port}/json`)).json(); - Network accessline 41
try { const targets = await (await fetch(`http://127.0.0.1:${port}/json`)).json(); const page = targets.find((t) => t.type === 'page'); - Network accessline 42
const targets = await (await fetch(`http://127.0.0.1:${port}/json`)).json();
skill/liquid-glass-web/scripts/serve.py
skill/liquid-glass-web/scripts/shoot.sh
- Executable scriptline 1
#!/bin/zsh
How the signals fit together
Facts from a static read of the files at the pinned commit. They describe what the code does, not why.
Some files could not be read; the facts below still hold.
Declared and executed: 1 fact
- Contacts www.w3.org, which SKILL.md, the README and the plugin manifest do not mentionliquid-glass-web/assets/liquid-glass.js:16High confidence
Signal confidence: 20 facts
- Network access in prose of the SKILL.mdliquid-glass-web/SKILL.md:8Low confidence
- Network access in prose of the SKILL.mdliquid-glass-web/SKILL.md:19Low confidence
- Executable script in a comment of a file that runsliquid-glass-web/assets/components.js:1Low confidence
- Network access in a comment of a file that runsliquid-glass-web/assets/components.js:2Low confidence
- Network access in a comment of a file that runsliquid-glass-web/assets/components.js:3Low confidence
- Network access in a comment of a file that runsliquid-glass-web/assets/components.js:4Low confidence
- Executable script in a comment of a file that runsliquid-glass-web/assets/glass-webgl.js:1Low confidence
- Executable script in a comment of a file that runsliquid-glass-web/assets/liquid-glass.js:1Low confidence
- Network access in code of a file that runsliquid-glass-web/assets/liquid-glass.js:16High confidence
- Network access in code of a file that runsliquid-glass-web/assets/liquid-glass.js:17High confidence
- Network access in prose of documentationliquid-glass-web/references/components.md:3Low confidence
- Network access in code of documentationliquid-glass-web/references/components.md:10Low confidence
- Executable script in code of a file that runsliquid-glass-web/scripts/chrome-shot.mjs:1High confidence
- Network access in code of a file that runsliquid-glass-web/scripts/chrome-shot.mjs:40High confidence
- Network access in code of a file that runsliquid-glass-web/scripts/chrome-shot.mjs:41High confidence
- Network access in code of a file that runsliquid-glass-web/scripts/chrome-shot.mjs:42High confidence
- Executable script in code of a file that runsliquid-glass-web/scripts/serve.py:1High confidence
- Network access in code of a file that runsliquid-glass-web/scripts/serve.py:59High confidence
- Network access in code of a file that runsliquid-glass-web/scripts/serve.py:60High confidence
- Executable script in code of a file that runsliquid-glass-web/scripts/shoot.sh:1High confidence
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Compatible | Standard SKILL.md skill/liquid-glass-web/SKILL.md | .claude/skills/<skill-name>/ |
| Codex | Compatible | Standard SKILL.md skill/liquid-glass-web/SKILL.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md skill/liquid-glass-web/SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md skill/liquid-glass-web/SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md skill/liquid-glass-web/SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md skill/liquid-glass-web/SKILL.md | .opencode/skills/<skill-name>/ |
- Native The repository ships a manifest, folder or frontmatter field for this agent.
- Compatible A standard SKILL.md that this agent can read.
- Unknown No evidence either way.
Derived automatically from paths, manifests and frontmatter. Not tested on each agent.