liquid_glass_hig 0.1.0-beta.3

iOS 26 Liquid Glass UI primitives for Flutter — containers, sheets, nav bars, controls. Pixel-matched to Apple's HIG. Material 3 fallback on Android.

Changelog

0.1.0-beta.3 — 2026-06-10

Changed

• README now embeds the components cover image inline (via raw GitHub URL) so it renders on the pub.dev package page above the description, not only inside the screenshots carousel.
• Fixed README header (liquid_glass → liquid_glass_hig) and added a pub.dev version badge.

0.1.0-beta.2 — 2026-06-10

Added

• screenshots: block in pubspec.yaml with a components cover image so pub.dev renders a preview on the package page.

0.1.0-beta.1 — 2026-06-03

First public release. Beta-tagged because the underlying shader engine (liquid_glass_renderer) is itself on a prerelease channel (^0.2.0-dev.4). We'll move to a stable 0.1.0 once it ships stable upstream.

iOS 26 Liquid Glass UI primitives for Flutter.

Rendering

The droplet refraction itself is delegated to liquid_glass_renderer (MIT, by Tim Lehmann / whynotmake.it). That package does the heavy shader work: SDF-based normals, physically-based refraction with a configurable refractiveIndex, chromatic dispersion, virtual-light rim highlights. liquid_glass then layers a curated widget catalog (cards, sheets, nav bars, controls, theme system, M3 fallback) on top.

Pinned to ^0.2.0-dev.4. Will move to ^0.2.x once a stable release ships.

Added

• Core
  • LiquidGlass — drop-in glass surface. Internally renders via lgr.LiquidGlass.withOwnLayer, with our shadow + theme integration layered around it.
  • LiquidGlassConfig — HIG-tuned defaults for thickness, blur, refractiveIndex, chromaticAberration, lightAngle, lightIntensity, ambientStrength, saturation, glassColor, outerShadowOpacity. Round-trips to lgr.LiquidGlassSettings via toRendererSettings().
• Theme
  • LiquidGlassTheme with clear / frosted / vibrant presets, .fromColorScheme(...) factory, and dark-mode adaptToBrightness.
  • LiquidGlassThemeScope (InheritedWidget) with Theme.of-style static lookup and an ambient-fallback when no scope is provided.
• Containers
  • GlassCard, GlassContainer, GlassPanel, GlassSection + GlassSectionRow.
• Sheets & modals
  • showGlassBottomSheet, showGlassDialog, showGlassActionSheet, showGlassPopover.
• Navigation
  • GlassNavigationBar, GlassScrollAwareNavigationBar (auto-elevates on scroll), GlassTabBar, GlassToolbar, GlassSegmentedControl<T>.
• Controls
  • GlassButton (3 variants + spring-physics press), GlassToggle, GlassChip, GlassSearchBar.
• Material 3 fallback
  • LiquidGlassFallback.override + isActive(context).
  • Fallback wiring for GlassCard → Card, GlassButton → M3 button, GlassToggle → Switch.adaptive, GlassTabBar → NavigationBar.

Example

iOS 26 Settings + Music + component-showcase replica in example/. Run on the iPhone 17 Pro simulator (iOS 26) for the closest match to the Apple reference.

Quality

• 34 unit + widget tests, all green.
• flutter analyze with strict-casts, strict-inference, strict-raw-types: zero issues.
• One runtime dependency: liquid_glass_renderer.