LiquidGlass
| iOS | Android |
![]() |
iOS 26+ only On Android, renders as a regular View with optional fallback background color. |
Native glass morphism effect using UIGlassEffect on iOS 26+. On Android and older iOS versions, renders as a regular View with optional fallback styling. Put glass views in a LiquidGlassContainer to have neighbours merge and morph into each other.
Note: LiquidGlass requires iOS 26+ at runtime, and the library must be built with Xcode 26 (the iOS 26 SDK). Built with an older Xcode, the glass code is compiled out and the component falls back to a blur, so the library still builds without Xcode 26. On older iOS versions and on Android, the component renders children without the glass effect. Use
isLiquidGlassSupportedto check availability and provide fallback UI — it reports what the build can actually do, not just the OS version.
Props
| Prop | Type | Description |
|---|---|---|
cornerRadius | number | Corner radius for the glass effect (default: 0) |
cornerStyle | 'capsule' | 'concentric' | number | Corner shape, a UICornerConfiguration on iOS 26. See Corner styles. Default: cornerRadius |
children | ReactNode | Content to render inside the glass container |
iOS Props (ios)
| Prop | Type | Description |
|---|---|---|
effect | 'clear' | 'regular' | 'none' | Glass effect intensity (default: 'regular') |
interactive | boolean | Enable touch interaction feedback (default: false) |
tintColor | string | Overlay tint color (hex string) |
colorScheme | 'light' | 'dark' | 'system' | Appearance mode (default: 'system') |
Android Props (android)
| Prop | Type | Description |
|---|---|---|
fallbackBackgroundColor | string | Background color when glass effect unavailable |
Constants
| Export | Type | Description |
|---|---|---|
isLiquidGlassSupported | boolean | true on iOS 26+ when built with the iOS 26 SDK, false otherwise |
Effect Modes
'regular'(default): Standard glass blur intensity with full glass morphism effect'clear': More transparent, subtle glass effect'none': No glass effect (useful for animating materialization/dematerialization)
Corner styles
cornerStyle sets the view's cornerConfiguration on iOS 26, which shapes the glass:
'capsule':.capsule(). The short sides are fully rounded and follow the view's size, so a button stays a pill as it grows.'concentric':.corners(radius: .containerConcentric()). Each corner is concentric with the matching corner of the shape around it: a parentLiquidGlass, or the screen's corners. A card inset 12 pt in a glass with a 36 pt radius gets 24 pt corners where it meets the outer corners, andcornerRadius(the minimum) elsewhere.- a number: a fixed radius, the same as
cornerRadius.
Without cornerStyle, cornerRadius is used as before (on iOS 26 it goes through cornerConfiguration too, so concentric children can follow it).
| iOS 26 |
|---|
![]() |
<LiquidGlass cornerRadius={36} style={{ padding: 12, gap: 10 }}>
<LiquidGlass cornerStyle="concentric" cornerRadius={8} style={{ flex: 1 }}>
{/* … */}
</LiquidGlass>
<LiquidGlass cornerStyle="capsule" style={{ height: 48 }}>
{/* … */}
</LiquidGlass>
</LiquidGlass>
Corner configurations are iOS 26 API. Elsewhere, 'capsule' rounds to half the shorter side and 'concentric' uses cornerRadius. That shows on Android, where the view has android.fallbackBackgroundColor; on iOS before 26 the view has no background, so the corners have nothing to shape.
Android (with android.fallbackBackgroundColor) |
|---|
Platform Behavior
| Platform | iOS 26+ | iOS < 26 | Android |
|---|---|---|---|
| Glass Effect | Full glass morphism | No effect | No effect |
| Corner Radius | Applied | Applied | Applied |
| Corner Style | cornerConfiguration | Capsule: half the short side; concentric: cornerRadius | Same as iOS < 26 |
| Tint Color | Supported | Ignored | Ignored |
| Interactive | Supported | Ignored | Ignored |
| Fallback BG | N/A | Transparent | Configurable |
| Container | Merging and morphing glass | Plain container | Plain container |
Usage Tips
- Check support first: Use
isLiquidGlassSupportedto conditionally render fallback UI - Background content: Glass effects work best over images or colorful backgrounds
- Interactive mode: Only applies on mount; cannot be toggled after initial render
- Android fallback: Set
android.fallbackBackgroundColorfor a semi-transparent background
LiquidGlassContainer
On iOS 26, glass that sits close together merges into one shape inside a glass container, which is how grouped toolbar buttons and expanding controls are drawn. LiquidGlassContainer is that container: a UIVisualEffectView with a UIGlassContainerEffect. The LiquidGlass views inside it render together, and neighbours within spacing blend into each other.
import { LiquidGlass, LiquidGlassContainer } from 'react-native-platform-components';
<LiquidGlassContainer spacing={24} style={{ flexDirection: 'row', gap: 8 }}>
<LiquidGlass cornerStyle="capsule" style={styles.button}>{/* … */}</LiquidGlass>
<LiquidGlass cornerStyle="capsule" style={styles.button}>{/* … */}</LiquidGlass>
{showMore && (
<LiquidGlass cornerStyle="capsule" style={styles.button}>{/* … */}</LiquidGlass>
)}
</LiquidGlassContainer>
The LiquidGlass views don't have to be direct children: any LiquidGlass below the container joins it, unless it sits inside another LiquidGlass.
| Prop | Type | Description |
|---|---|---|
spacing | number | How far apart glass can be and still merge (UIGlassContainerEffect.spacing). iOS 26 only. Default: the system's, 0 on iOS 26, where glass doesn't merge across gaps |
children | ReactNode | Content, with the LiquidGlass views that merge |
spacing is UIKit's value, not a gap: in the example, two buttons 8 pt apart stay separate at 12 and merge at 24.
| Default spacing (iOS 26) | spacing={24} (iOS 26) |
|---|---|
![]() | ![]() |
Morphing
Changes inside a container that's on screen animate, so the glass morphs instead of popping:
- A
LiquidGlassappears: its glass materializes (UIKit animateseffectfromnilto aUIGlassEffectin an animation block), and grows out of the neighbours it merges with. - A
LiquidGlassgoes away: React removes the view at once, so a copy of its glass stays in the container and dematerializes in its place. At the edge of the container, the copy shrinks into the neighbour it was merged with. - A
LiquidGlasschanges frame (it widens, or moves because a sibling came or went): the new frame is applied in a spring animation, which reshapes the merged glass. The container animates its own size the same way, since it clips the glass near its bounds. - A
LiquidGlasschanges corners (cornerStyleorcornerRadius): the new corners animate with the frame, so a capsule that grows into a card rounds into the card's corners. GlassDisclosure is built on this.
| iOS 26: a button appears, then the first one widens |
|---|
![]() |
Glass that arrives with the container (the first render, or a screen that comes back) appears without an animation, unless it starts with ios.effect: 'none': then it materializes when it gets an effect. Only the glass itself morphs: the React content inside a LiquidGlass takes its new layout at once. A new spacing applies without an animation.
Keep the container in place. Glass that changes frame while it is detached from its container jumps to the new frame instead of morphing, and Fabric detaches views more often than the React tree suggests:
- a view inserted ahead of the container (a backdrop rendered only while something is open) makes Fabric move the container;
- a view whose children Fabric flattens into its parent stops being flattened when a prop such as
accessibilityViewIsModal,pointerEvents('none'or'box-only'),opacityorimportantForAccessibilitychanges, and Fabric moves its children into the new native view.
Keep such views mounted, and give the ones whose props change collapsable={false}, from the container up to the screen. Check the morph in a Release build: a Debug build's slower mounting can hide the jump.
Fallback
UIGlassContainerEffect is iOS 26 API. On Android, on older iOS and on web, LiquidGlassContainer is a plain container: the LiquidGlass views inside render as they do anywhere else, and spacing does nothing.
| iOS 18 | Android (with android.fallbackBackgroundColor) |
|---|---|
![]() | ![]() |






