---
title: "Liquid Glass React libraries compared (2026)"
description: "Liquid Glass React libraries compared: how liquid-glass-react, @samasante/liquid-glass and WebGL options render, which browsers refract, which to pick."
url: https://liquidglassdesign.com/blog/liquid-glass-react-libraries
language: en
published: 2026-11-18
updated: 2026-11-20
author: "Liquid Glass Design"
tags: ["Web","Code"]
translations:
  zh-Hans: https://liquidglassdesign.com/zh/blog/liquid-glass-react-libraries.md
  zh-Hant: https://liquidglassdesign.com/zh-TW/blog/liquid-glass-react-libraries.md
  ja: https://liquidglassdesign.com/ja/blog/liquid-glass-react-libraries.md
  hi: https://liquidglassdesign.com/hi/blog/liquid-glass-react-libraries.md
---

# Liquid Glass React libraries compared (2026)

> Liquid Glass React libraries compared: how liquid-glass-react, @samasante/liquid-glass and WebGL options render, which browsers refract, which to pick.

For Liquid Glass in React, the main choice is between `liquid-glass-react`, the most-downloaded glass component, which bends the backdrop in Chromium only, and `@samasante/liquid-glass`, a newer headless lens that can refract in Chrome, Safari and Firefox as long as you give it the content to bend. The others are a fork of the first, WebGL renderers that work from screenshots, and a liquid-morph library that isn't glass at all.

All numbers below come from npm, GitHub and Bundlephobia on November 14, 2026. "Downloads" means npm downloads over the 30 days before that date.

## How the libraries make glass

There are three techniques, and they explain nearly every difference in browser support.

1. An SVG displacement filter that reads the page behind the element (`backdrop-filter: url()`, or `filter: url()` stacked on a `backdrop-filter` blur). This bends live content, but only Chromium draws it. Safari and Firefox fall back to a flat blur.
2. An SVG displacement filter applied with `filter: url()` to content the component owns. This works in all three engines because it never reads the backdrop. The catch is that the component has to have its own copy of what it bends.
3. A WebGL shader drawing over a screenshot or a canvas. It's very flexible visually, but anything rasterized from the DOM is a still image until you capture it again.

Our [CSS and SVG Liquid Glass tutorial](https://liquidglassdesign.com/blog/liquid-glass-css-svg) shows the first two in plain code if you want to see what these packages wrap.

## The Liquid Glass React libraries

### liquid-glass-react

Max Rovensky's [Liquid Glass React](https://liquidglassdesign.com/resources/liquid-glass-react) (`rdev/liquid-glass-react` on GitHub) is the one most people find first. It has about 6,700 GitHub stars and roughly 152,000 npm downloads in the last 30 days.

- It uses technique 1. The component applies an SVG `feDisplacementMap` filter with `filter: url()` on top of a `backdrop-filter` blur, runs three displacement passes for chromatic aberration, and skips the SVG filter entirely in Firefox. The README says that Safari and Firefox "only partially support the effect (displacement will not be visible)".
- Props cover `displacementScale`, `blurAmount`, `saturation`, `aberrationIntensity`, `elasticity` and `cornerRadius`, plus `mode` ("standard", "polar", "prominent" or "shader"). The README calls shader mode "the most accurate but not the most stable".
- Version 1.1.1, MIT license, peer dependency React 19 or newer. Bundlephobia measures about 33 KB gzipped.
- The last commit and release are from June 2025. There are 25 open issues and pull requests, including issue #20: the component always applies `translate(-50%, -50%)` centering, which makes it hard to place in normal layout.

It suits a Chromium-heavy audience, a landing page or a demo where the mouse-following elasticity is the point. For a production UI that has to look right on iPhone, look at the next package.

`@nkzw/liquid-glass` is a fork of it "with styling fixes, TypeScript package fixes, and some simplifications". It accepts React 18 or newer. Its last release (1.3.0) is from June 2025 too, and the rendering approach and browser note are the same.

### @samasante/liquid-glass

Sam Asante's package is on our resources page as [Real liquid glass for the web](https://liquidglassdesign.com/resources/real-liquid-glass-for-the-web). It's a headless `<Glass>` component: you style the box with your own CSS or Tailwind, and the component turns it into the material.

- It uses technique 2, with technique 1 as an option. Wrapping a styled box frosts, tints and edge-lights it everywhere, and bends the live page behind it in Chrome and Edge only, since that path needs `backdrop-filter: url()`. To bend in Safari and Firefox, you either let the lens refract its own children (give it `size` and `center`) or pass `refract={<img src="/photo.jpg" />}` so it bends a copy of what sits behind it.
- For `<video>` and `<canvas>` it switches to WebGL, because Safari won't run an SVG filter on a live video.
- Its `BROWSERS.md` documents the Safari workarounds: no supersampling in WebKit, map regeneration only when the shape changes, and a new filter ID on each update because WebKit caches filter output by ID.
- Version 0.1.1 from June 23, 2026, MIT, zero runtime dependencies, peer React 18 or newer. Bundlephobia measures about 17 KB gzipped. It had roughly 63,000 downloads in the last 30 days and about 670 GitHub stars.
- The repository hasn't had a commit since June 23, 2026, about an hour after it was created, so pin the version and read the source before you depend on it.

### Liqui, a component library (ours)

[Liqui](https://liqui.design/?utm_source=liquidglassdesign.com&utm_medium=referral&utm_campaign=blog_react_libraries) is our own open-source project, so weigh this entry with that in mind. It's a set of 38 Base UI components (buttons, menus, selects, dialogs, sliders, an iOS-style tab bar and the form controls around them) that the shadcn CLI writes into your repo as source. The refraction kernel is the one npm dependency, `@liqui-design/glass`.

- It uses technique 1 in Chromium and technique 2 in Safari and Firefox: wrap an area in `LiquiBackdrop`, and every glass surface inside it bends a copy of that backdrop where the page itself can't be refracted. A surface with no known backdrop, or a popup portalled out of the box, frosts and keeps its rim light.
- Displacement maps are drawn once on a canvas and cached by size and optics, and every filter lives in one shared SVG registry, so many identical buttons cost one map.
- `@liqui-design/glass` 0.8.0 is from November 17, 2026, MIT, peer React 18 or 19, and the components need Tailwind CSS v4. It had about 5,000 npm downloads in the 30 days to November 18 and about 170 GitHub stars (checked November 20, 2026).
- Setup, the tab bar and the Safari details are in our guide to [Liquid Glass components for React](https://liquidglassdesign.com/blog/liquid-glass-react-components).

### WebGL options

`@specy/liquid-glass-react` renders with Three.js. Its React API has an `updateScreenshot()` method, so the glass shows a captured image of the page that you refresh yourself. It weighs about 220 KB gzipped on Bundlephobia, and its last release (1.0.2) dates from June 2025. That's fine for a hero visual over a static background and a poor fit for UI over content that changes.

Charles Yin's [Liquid Glass Studio](https://liquidglassdesign.com/resources/liquid-glass-studio) is an MIT-licensed playground rather than a component library, built on WebGL2 and WebGPU with detailed controls. The repo was updated in September 2026. It's a good place to see how far a shader can push the look, and to borrow the math if your glass sits over a canvas scene you already render.

### liquid-gooey, for the morphing part

[Liquid Gooey](https://liquidglassdesign.com/resources/liquid-gooey) by Jakub Antalik covers the morphing side of the look instead of the lens: shapes that merge and split like liquid, with "Morph" and "Move" effects. It draws the goo on an SVG silhouette layer and keeps your real DOM crisp on top, and its README says it filters SVG content and never uses CSS `url()` on HTML, which is how it stays correct in Safari. Version 0.2.2 from September 2026, MIT, peer React 18 or newer, about 17 KB gzipped, and about 318,000 downloads in the last 30 days. Pair it with a blur-based glass surface when you want a menu to bud out of a button.

## A decision rule

1. If iPhone and Safari users must see refraction, use `@samasante/liquid-glass` and refract either the element's own children or a copy you pass in. Accept that a panel floating over arbitrary live content will only frost, not bend, outside Chromium.
2. If you want a whole set of glass components (menus, selects, dialogs, a tab bar) on shadcn/ui and Tailwind v4, use Liqui, our library. It refracts in Safari and Firefox inside a `LiquiBackdrop` and frosts elsewhere.
3. If your audience is mostly desktop Chrome and you want a drop-in component with mouse elasticity, `liquid-glass-react` works. Make sure the flat-blur fallback looks finished, and budget time for the positioning quirk.
4. If you only need a few buttons or a nav bar, skip the dependency. The filter and map generator from our tutorial are a few dozen lines, and you control the fallback.
5. If the content under the glass is a canvas, a 3D scene or a video, use a shader, or `@samasante/liquid-glass` in its WebGL mode for video.
6. If what you really want is the merging and morphing, use `liquid-gooey` and keep the glass itself simple.

Sanoj Sunny's [volume slider concept](https://liquidglassdesign.com/gallery/liquid-glass-slider-concept%28volume%29) is a good test case for any of these libraries. A clear glass track sits over a photo, the level (52) is a second pill inside it, and a round button floats beside it. Rebuilding that in Safari means refracting a copy of the photo, which `@samasante/liquid-glass` does through its `refract` prop and `liquid-glass-react` can't do.

![Clear glass volume slider at 52 and a round AirPlay-style button floating over a dark photo of a hand holding a speaker](https://cdn.liquidglassdesign.com/gallery/296cd13d-8a84-8095-9a94-c13755eef388.webp)

*Liquid Glass - Slider Concept(Volume) by sanoj sunny.* [See it in the gallery](https://liquidglassdesign.com/gallery/liquid-glass-slider-concept%28volume%29)
Roman Vasylovskyi's [Liquid glass navigation](https://liquidglassdesign.com/gallery/liquid-glass-navigation) is the harder case from rule 1: a site header floating over a full-bleed photo of a dune, with the ridge line visibly bent inside the bar. Over a fixed hero image you can pass the same photo to `@samasante/liquid-glass`. Once the page scrolls under the header, only Chromium will show the bend, whichever library you use.

![Glass nav bar with links and a Get Started button over a dark dune whose ridge line bends behind the bar](https://cdn.liquidglassdesign.com/gallery/22acd13d-8a84-80ef-8228-f1b3eeb5f2e1.webp)

*Liquid glass navigation by Roman Vasylovskyi.* [See it in the gallery](https://liquidglassdesign.com/gallery/liquid-glass-navigation)
Whatever you choose, the [web performance and fallback guide](https://liquidglassdesign.com/blog/liquid-glass-web-performance-fallbacks) covers the solid fallback for `prefers-reduced-transparency` and how many glass layers a page can afford.

## Liquid Glass for Vue

The [Liquid Glass Vue](https://liquidglassdesign.com/resources/liquid-glass-vue) project on our resources page is a Vue 3 and Vite demo that renders refraction with WebGL. It's a project to learn from rather than a package you install, and GitHub doesn't detect a license file in the repo, so ask the author before copying code into a commercial product. For a component, `liqvued` on npm (MIT, version 0.2.1 from July 2026, Vue 3.5 or newer) uses `backdrop-filter: url()` in Chromium and, according to its docs, falls back to a blur in Safari and Firefox.

*Versions, settings and figures checked on 14 November 2026.*

## Sources

- https://github.com/rdev/liquid-glass-react
- https://github.com/rdev/liquid-glass-react/blob/master/src/index.tsx
- https://github.com/rdev/liquid-glass-react/issues/20
- https://www.npmjs.com/package/liquid-glass-react
- https://github.com/nkzw-tech/liquid-glass
- https://github.com/samasante/liquid-glass
- https://liqui.design/docs/handbook/glass
- https://www.npmjs.com/package/@liqui-design/glass
- https://github.com/leefanv/liqui-design
- https://github.com/samasante/liquid-glass/blob/main/BROWSERS.md
- https://www.npmjs.com/package/@samasante/liquid-glass
- https://github.com/Specy/liquid-glass
- https://www.npmjs.com/package/@specy/liquid-glass-react
- https://github.com/iyinchao/liquid-glass-studio
- https://github.com/Jakubantalik/Libraries
- https://www.npmjs.com/package/liquid-gooey
- https://github.com/Muggleee/liquid-glass
- https://www.npmjs.com/package/liqvued
- https://ivoyt.github.io/liqvued/guide/browser-compatibility
- https://bundlephobia.com/package/liquid-glass-react
- https://api.npmjs.org/downloads/point/last-month/liquid-glass-react
