explaingit

obaidqatan/liquid-glass-component-library

Analysis updated 2026-05-18

9TypeScriptAudience · vibe coderComplexity · 2/5LicenseSetup · easy

TLDR

A collection of 70+ React components with frosted and refractive glass surfaces inspired by Apple's iOS design, with live controls for blur, transparency, and refraction.

Mindmap

mindmap
  root((liquid-glass))
    Visual modes
      Frosted glass
      Liquid Glass refractive
      Dark and light themes
    Component types
      Buttons and inputs
      Cards and layouts
      Navigation
      Modals and overlays
      Data display
    Tech
      React 19
      TypeScript
      Tailwind CSS
      Framer Motion
    Usage
      pnpm install
      pnpm run dev
      Single file build
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Copy components from this library into a React project to quickly get an Apple-inspired frosted glass visual style.

USE CASE 2

Use the demo playground to tune blur, transparency, and refraction settings before deciding on a glass style for your app.

USE CASE 3

Study the SVG filter technique used in the liquid glass mode to understand how refractive glass effects work in a browser.

What is it built with?

TypeScriptReactTailwind CSSFramer MotionVite

How does it compare?

obaidqatan/liquid-glass-component-librarymaximseshuk/payload-plugin-openapicodee-sh/payload-training-app
Stars9910
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity2/52/54/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires pnpm, the demo is a single built HTML file that needs no server to open.

MIT license: use freely in any project, including commercial work, with no restrictions beyond keeping the copyright notice.

In plain English

This is a collection of over 70 React components built around a frosted glass and refractive glass visual style, inspired by the translucent surfaces seen in Apple's iOS design. The project started as a personal experiment to see how close a web browser could get to that look using only standard web technologies. There are two modes. The standard frosted glass mode creates the familiar blurred, semi-transparent surface effect and exposes sliders for blur strength, transparency, and color saturation. The experimental liquid glass mode uses a different technique, involving SVG filters, to create a refractive effect where light appears to bend through the surface, closer to how real glass looks. Both modes can be adjusted live in a demo playground. The component set covers the full range of things you would need to build an interface: buttons, cards, input fields, toggles, sliders, checkboxes, dropdowns, modals, drawers, tooltips, navigation bars, tab bars, tables, calendars, carousels, and more. There are also mobile-specific versions of many components such as action sheets, bottom tab bars, and notification drawers. Animations use a library called Framer Motion with spring-based physics. The demo app builds into a single HTML file that works as both the documentation and a live playground where you can see every component and tweak the glass settings. Setup requires running a package install and a dev server command. The README notes clearly that this is a personal sandbox project and contributions are not accepted at this time. It is labeled experimental, meaning the API and visual output may change. The license is MIT, so the components can be used freely in other projects.

Copy-paste prompts

Prompt 1
I'm using the liquid-glass-component-library. Add a LiquidGlassModal that opens when a LiquidGlassButton is clicked, and style both with the dark theme.
Prompt 2
How do I tune the ThemeProvider in liquid-glass-component-library to get a subtle, barely-visible glass effect with low blur and high transparency?
Prompt 3
Show me how to build a settings panel in React using LiquidGlassCard, LiquidGlassToggle, and LiquidGlassSlider from the liquid-glass library.

Frequently asked questions

What is liquid-glass-component-library?

A collection of 70+ React components with frosted and refractive glass surfaces inspired by Apple's iOS design, with live controls for blur, transparency, and refraction.

What language is liquid-glass-component-library written in?

Mainly TypeScript. The stack also includes TypeScript, React, Tailwind CSS.

What license does liquid-glass-component-library use?

MIT license: use freely in any project, including commercial work, with no restrictions beyond keeping the copyright notice.

How hard is liquid-glass-component-library to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is liquid-glass-component-library for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub obaidqatan on gitmyhub

Verify against the repo before relying on details.