NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #1849 most downloaded on pub.dev
An iOS 27-style liquid glass renderer for Flutter.
Last release 26 days ago
27 Oct 2026
Ships unpredictably
gaps range from 8 days to 11 months
Unknown
no stable releases
Nothing withdrawn
no release was ever pulled
1 years old
34 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
liquid_glass_renderer@1.0.0-dev.2
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
PERF(liquid_glass_renderer): keep the FakeGlass filter while its blur holds (#250).
Key the consolidated layer's shared filter cache on the blur sigma the layer's short side produces, not on the short side itself, so an animated size that leaves the sigma alone keeps the filter object and its backdrop saveLayer.
PERF(liquid_glass_renderer): crop backdrop blurs with a seeded pass (#248).
Impeller crops a backdrop blur to where it is needed only when the blur is the outermost filter, so a glass's compose(blur, shader) blurred the whole backdrop. Paint each glass's filter inside a small pass seeded by a plain blur (or an identity where Impeller would not crop the blur), and run only what follows the blur over that pass.
Seeded passes are on wherever Impeller renders, except under flutter test (flutter_tester renders them wrongly) and inside a LiquidGlassCapture, whose own pass already holds the backdrop. Every seed reads the backdrop for itself unless the glass was given a backdrop key. Pass sizes are bucketed so Impeller can reuse their render targets; the bucket sizes live in PixelBuckets.
PERF(liquid_glass_renderer): draw only the low-res matte near the shapes (#249).
When the texels near a shape are at most 90% of the low-res matte, clear the texture to "far outside" and limit the geometry draw to those texels with a scissor. The clear writes the same value the shader writes for a texel far from every shape, so the matte doesn't change.
PERF(liquid_glass_renderer): render the geometry matte at low resolution (#252).
The geometry pass now draws a low-res matte: one RGBA16F texel for every 4 x 4 block of matte pixels (2 x 2 below a device pixel ratio of 2). Each texel holds the distance to the edge, the direction the surface faces (shortened where refraction should be weaker) and half of the shape's shorter side. The final shader reads it with linear filtering, which blends the four nearest texels, and computes the antialiased edge, the refraction and the rim lighting for each pixel. The geometry pass does about 16x less work per change (4x at a scale of 2). The old full-resolution matte and displacement_encoding.glsl are gone.
The final shader also skips the surface direction, the rim lighting and vibrancy wherever they would add nothing.
Goldens of real glass are regenerated on macOS 27.0.1 (26A434).
PERF(liquid_glass_renderer): keep shadow layer bounds on pixel buckets (#251).
Expand the shadow save layers' bounds to pixel buckets, so an animated shape keeps one render target size instead of allocating a new one every frame. The bounds only limit the layer, so no pixel changes.
FIX(liquid_glass_renderer): keep a glass's look independent of the other shapes in its layer (#253).
FIX(liquid_glass_renderer): decode exterior edge distance without a ternary on Mali Vulkan (#246).
On Mali GPUs under Vulkan (Pixel 8 / Tensor G3, Pixel 9 Pro / Tensor G4), the ternary in decodeSignedEdgeDistance returns 0 for an empty matte texel (B = 0) instead of -exteriorRange. Every pixel of the filter bounds outside the shape then passes the early return with materialAlpha 0.5 and renders as half-covered material: tint, contour and bevel shadow fill the whole bounding rectangle. Metal and Impeller OpenGL ES render correctly. Selecting the range with step()/mix() decodes correctly on all three.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Bump liquid_glass_renderer and apple_liquid_glass from dev.0 to dev.1 with the iOS 27 highlight, merged-seam, color/size, and additive FakeGlass HDR c
Bump liquid_glass_renderer and apple_liquid_glass from dev.0 to dev.1 with
the iOS 27 highlight, merged-seam, color/size, and additive FakeGlass HDR
changes. No public API changes.
A rendering release with no public API changes.
0.6) instead of overexposing the
first pixel inside the silhouette, and make the merged-shape glint match the
same rim profile.chore: release as 1.0.0-dev.0
chore: release as 1.0.0-dev.0 (#239)
Note: This release has breaking changes.
A rewrite of the renderer on Flutter GPU, fitted against iOS 27 Liquid Glass.
It replaces the 0.2.x API without deprecations. This is an experimental
prerelease; APIs and rendering may still change.
--enable-flutter-gpu, FLTEnableFlutterGPU, or
io.flutter.embedding.android.EnableFlutterGPU). Everywhere else layers
render FakeGlass. The minimum Flutter version is 3.47.0.LiquidGlassSettings keeps the optics and lighting
shared by a layer. Color and visibility move to the new per-shape
LiquidGlassAppearance, set on a LiquidGlass or as a layer's
defaultAppearance.glassColor becomes LiquidGlassAppearance.tint.saturation becomes LiquidGlassColorModel.direct(saturation: ...).visibility moves to LiquidGlassAppearance.visibility and the new
LiquidGlassVisibility widget.blur becomes frost, a blur sigma in logical pixels.thickness becomes refractionHeight, the width of the refracting bevel.
0 now means flat glass instead of no glass.refractiveIndex becomes refractionAmount, the displacement in logical
pixels at the silhouette, falling off across the bevel as a quarter
circle.chromaticAberration becomes dispersion, and defaults to 0.lightIntensity becomes highlight. 1 now matches the iOS 27 glint on
an iPhone.lightAngle and ambientStrength are removed; the light direction is no
longer configurable.LiquidGlassSettings.figma is removed for now. It may come back in a
later release.glassContainsChild is removed
from every LiquidGlass constructor. Children are clipped to the shape but
never blurred, tinted or refracted.Opacity between a layer and its shapes. It only faded the
children, not the glass. Use LiquidGlassVisibility or
LiquidGlassAppearance.visibility. Opacity above a whole
LiquidGlassLayer still works.0.2.x. These defaults may be
retuned before 1.0; the ios27* presets track iOS 27. Preset and default
frost is raised further on the device so Impeller downsamples the blur pass,
capped at the 2x value; an explicit frost is used as given.GlassColorParameters.ios27Dark transmittance no longer blends a small- and
a large-side curve by the shape's short side, which the layer could only
feed as the smallest shape's short side. Both curves are replaced by their
equal-weight midpoint, so small shapes render slightly darker and large
shapes slightly lighter. Other presets are unchanged.LiquidShape is sealed; LiquidOval, LiquidRoundedRectangle and
LiquidRoundedSuperellipse are final: the set of shapes is closed and
switches over a LiquidShape are exhaustive, so adding a shape later is
a compile-time error rather than silently falling through. The glass
ignores a shape's side.LiquidGlassSettings, LiquidGlassAppearance and LgrLogs are final.LiquidGlass.grouped and LiquidGlass.withOwnLayer no longer take
blendGroupLink, and the grouped, blendGroupLink and
ownLayerConfig fields are gone from LiquidGlass.FakeGlass and FakeGlass.inLayer no longer take
backdropHandledByLayer.LiquidGlassBlendGroup.of and maybeOf and the
LiquidGlassSettings.effective* getters are internal.LiquidGlassAppearance keeps only tint, visibility and colorModel.
Its saturation, transmissionGamma and vibrancy are removed and move
onto LiquidGlassColorModel.direct(saturation:, transmissionGamma:, vibrancy:); the iOS 27 models carry the whole transfer in their fitted
parameters.LiquidGlassAppearance.ios27Toolbar* presets are removed, and
LiquidGlassSettings.ios27Toolbar* are renamed to ios27Regular,
ios27RegularLight and ios27RegularDark.toJson/fromJson and
LgrLogs.ios27Regular and ios27Clear on both
LiquidGlassSettings and LiquidGlassAppearance (with light and dark
variants of regular), fitted against captures of Apple's glass in light and
dark.LiquidGlassSettings.tintAmount takes the
position of the iOS 27 Settings slider, from Clear (0) to Tinted (1). It
moves the iOS 27 wash and border along fitted curves, and the presets derive
their blur from it through LiquidGlassSettings.ios27RegularFrost and
ios27ClearFrost.LiquidGlassColorModel: the iOS 27 models turn
one tint and its opacity into backdrop-dependent tones, with dark regular
glass getting denser on larger shapes. The direct model exposes
saturation, transmissionGamma and vibrancy for manual looks.refractionFitsShape (default true) shrinks the
lens on small shapes like iOS 27 regular glass; clear glass keeps the full
lens. backdropShrink shrinks the backdrop seen through the face and never
enlarges it. The backdrop is sampled bilinearly so refracted lines don't
snap to pixels.contourStrength, contourDirectionality); and an inner shadow cast by
the rim (bevelShadowStrength). The rim geometry is the fitted iOS 27 one
and is not configurable.LiquidGlassAppearance; blended neighbors cross-fade where they meet
without another backdrop capture.LiquidGlassBlendGroup keep shared
straight edges straight and round only concave joins and bridges, as in
iOS 27's GlassEffectContainer.LiquidGlassVisibility fades glass in a subtree: refraction, lighting,
blur and children fade together. Nested scopes multiply, and a layer with
no visible shapes stops sampling the backdrop.LiquidGlassCapture captures the backdrop once, only as large as the
glass inside, so glass on glass (an indicator refracting its tab bar) no
longer pays a second full-screen readback.LiquidGlass.auto renders on a parent layer if there is one and
creates its own otherwise.LiquidGlass.precache() loads the shaders and warms the Flutter GPU
pipeline before runApp, so the first glass on screen renders fully.backdropKey on LiquidGlassLayer shares a backdrop capture between
layers explicitly.shadows, cut out behind the translucent glass, also under
blended shapes.FakeGlass rework. It renders at layer level with the same foreground
order as full glass and keeps frost, tint, color response, glint, border,
inner shadow, visibility and exterior shadows. Only refraction is missing.
The web build compiles and renders FakeGlass.frost is used as given.LiquidGlassBlendGroup.maxShapesPerLayer and drops the rest.liquid_glass_renderer@0.2.0-dev.4
Note: This release has breaking changes.
liquid_glass_renderer@0.2.0-dev.3
FIX: improve logging readability and names.
FIX: don't create intermediate images for geometry until it's settled.
This should decrease memory consumption somewhat, as a layer with one animating geometry would create 2 images per frame before
FEAT: export debugPaintLiquidGlassGeometry (#111).
liquid_glass_renderer@0.2.0-dev.2
liquid_glass_renderer@0.2.0-dev.1
Note: This release has breaking changes.
FIX: adjust LiquidGlassSettings defaults to match the look more closely.
FEAT: cache geometry images as well to make sure we only run the geometry shader when absolutely necessary.
DOCS: mention Impeller requirement earlier in README.
DOCS: update README with newest changes and performance tips.
BREAKING REFACTOR: remove the unsupported experimental widget API.
BREAKING REFACTOR: renamed many constructors and default LiquidGlass to not creating its own layer.
Please read the README to understand how to use this package.
BREAKING REFACTOR: LiquidGlassShapes now take a simple double as radius.
BREAKING REFACTOR: move blend setting from LiquidGlassSettings to LiquidGlassBlendGroup.
BREAKING FEAT: adjust fake glass light intensity.
BREAKING FEAT: rewrote rendering pass to use two passes.
We now cache all geometry into textures first, then render liquid glass in a second pass. This allows us to save a lot of cycles while glass shapes are static.
liquid_glass_renderer@0.1.1-dev.26
Note: This release has breaking changes.
FIX: only run shader on bounding box pixels.
FIX: set alwaysNeedsCompositing correctly on FakeGlass.
BREAKING REFACTOR: change default blend value to 0 in LiquidGlassSettings.
BREAKING REFACTOR: move fake parameter to LiquidGlassLayer and make entire layer fall back to fake glass on Skia.
BREAKING FEAT: visibility parameter in LiquidGlassSettings.
This can be used to scale all relevant properties of the liquid glass effect at once.
If you have made glass appear and disappear manually before, you can now simply animate the visibility between 0 and 1.
FEAT: add fake parameter to LiquidGlass to enable it to turn into FakeGlass dynamically (#103).
fake parameter to LiquidGlass to enable it to turn into FakeGlass dynamically (#103).FIX: import @internal from meta again (#102).
@internal from meta again (#102).FakeGlass.inLayer which adopts settings from the nearest ancestor layer.> Note: This release has breaking changes.
Note: This release has breaking changes.
> Note: This release has breaking changes.
Note: This release has breaking changes.
FIX: reduce texture samples (#94).
FEAT: small performance wins in shader (#91).
BREAKING REFACTOR: remove restrictThickness.
BREAKING FEAT: rewrote the rendering process to use two passes.
This significantly improves performance while glass elements are static on screen. Moving glass elements will still induce the same performance cost as before.
> Note: This release has breaking changes.
Note: This release has breaking changes.
Glassify for significant performance gains (#90).FIX: resistance parameter didn't actually get used.
resistance parameter didn't actually get used.> Note: This release has breaking changes.
Note: This release has breaking changes.
TileMode.mirror in FakeGlass blur.resistance in LiquidStretch.RawLiquidStretch for custom pixel-based stretching.Offset.withResistance extension method.LiquidStretch now bases its stretch on the child's size.Note: This release has breaking changes.
TileMode.mirror in FakeGlass blur.resistance in LiquidStretch.RawLiquidStretch for custom pixel-based stretching.Offset.withResistance extension method.Glassify to an experimental.dart import.LiquidStretch now bases its stretch on the child's size.FIX: removed unused transform from shader (#88).
FEAT: tried to improve the fidelity of fake light once more.
FIX: import annotations from package:meta again.
package:meta again.> Note: This release has breaking changes.
Note: This release has breaking changes.
FakeGlass (#83).StretchGlass to LiquidStretch.FIX: LiquidGlassLayer breaks when no child glass widgets are found.
LiquidGlassLayer breaks when no child glass widgets are found.DOCS: update README and add better disclaimer (#80).
> Note: This release has breaking changes.
Note: This release has breaking changes.
LiquidGlass applies transform to children.GlassGlowLayer and GlassGlow widget for glow effects.StretchGlass widget that can stretch its child with user gestures.FakeGlass widget that aims to match LiquidGlass appearance while being much more performant.lightness parameter from shader and LiquidGlassSettings.glassContainsChild to false.> Note: This release has breaking changes.
Note: This release has breaking changes.
> Note: This release has breaking changes.
Note: This release has breaking changes.
DOCS: fix errors in README (#31).
FIX: glass now also renders when blend is set to 0.
Glassify widget that turns any child shape into liquid glass.FIX: throw AssertionError when used without Impeller.
AssertionError when used without Impeller.FIX: liquid glass not repainting in route transitions (#16).
> Note: This release has breaking changes.
Note: This release has breaking changes.
FIX: fix shader on flutter stable.
- DOCS: new shape names.
> Note: This release has breaking changes.
Note: This release has breaking changes.
clipBehavior to LiquidGlass.DOCS: update pubspec and readme.
- FEAT: initial release.
One column per month.