Liquid Glass React

Apple's Liquid Glass effect for React.

| Card Example | Button Example | | :------------------------------------------------------------------------: | :--------------------------------------------------------------------------: | | | |

🎬 Demo

Click here to see it in action!

What is this?

A fork of liquid-glass-react with styling fixes, TypeScript package fixes, and some simplifications.

Getting Started

npm install @nkzw/liquid-glass

✨ Features

• Proper edgy bending and refraction
• Multiple refraction modes
• Configurable frosty level
• Supports arbitrary child elements
• Configurable paddings
• Correct hover and click effects
• Edges and highlights take on the underlying light like Apple's does
• Configurable chromatic aberration
• Configurable elasticity, to mimic Apple's "liquid" feel

⚠️ NOTE: Safari and Firefox only partially support the effect (displacement will not be visible)

Basic Usage

import LiquidGlass from '@nkzw/liquid-glass';

function App() {
  return (
    <LiquidGlass>
      <div className="p-6">
        <h2>Your content here</h2>
        <p>This will have the liquid glass effect</p>
      </div>
    </LiquidGlass>
  );
}

Button Example

<LiquidGlass
  aberrationIntensity={2}
  blurAmount={0.1}
  borderRadius={100}
  displacementScale={64}
  elasticity={0.35}
  onClick={() => console.log('Button clicked!')}
  padding="8px 16px"
  saturation={130}
>
  <span className="text-white font-medium">Click Me</span>
</LiquidGlass>

Mouse Container Example

When you want the glass effect to respond to mouse movement over a larger area (like a parent container), use the mouseContainer prop:

function App() {
  const containerRef = useRef<HTMLDivElement>(null);

  return (
    <div ref={containerRef} className="w-full h-screen bg-image">
      <LiquidGlass
        mouseContainer={containerRef}
        elasticity={0.3}
        style={{ position: 'fixed', top: '50%', left: '50%' }}
      >
        <div className="p-6">
          <h2>Glass responds to mouse anywhere in the container</h2>
        </div>
      </LiquidGlass>
    </div>
  );
}

Props

| Prop | Type | Default | Description | | --------------------- | -------------------------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------- | | children | React.ReactNode | - | The content to render inside the glass container | | displacementScale | number | 70 | Controls the intensity of the displacement effect | | blurAmount | number | 0.0625 | Controls the blur/frosting level | | saturation | number | 140 | Controls color saturation of the glass effect | | aberrationIntensity | number | 2 | Controls chromatic aberration intensity | | elasticity | number | 0.15 | Controls the "liquid" elastic feel (0 = rigid, higher = more elastic) | | borderRadius | number | 999 | Border radius in pixels | | className | string | "" | Additional CSS classes | | padding | string | - | CSS padding value | | style | React.CSSProperties | - | Additional inline styles | | overLight | boolean | false | Whether the glass is over a light background | | onClick | () => void | - | Click handler | | mouseContainer | React.RefObject<HTMLElement \| null> \| null | null | Container element to track mouse movement on (defaults to the glass component itself) | | mode | "standard" \| "polar" \| "prominent" \| "shader" | "standard" | Refraction mode for different visual effects. shader is the most accurate but not the most stable. | | globalMousePos | { x: number; y: number } | - | Global mouse position coordinates for manual control | | mouseOffset | { x: number; y: number } | - | Mouse position offset for fine-tuning positioning |