# g1455

> Liquid Glass for Flutter: refraction, blur, tint and a rim over the live backdrop. One GlassHost
> captures what is under all of its glass, only when something there changed; every surface samples
> that capture. Package `g1455` on pub.dev, version 0.1.4, Flutter 3.47 or later.

Writing code with g1455? Install the agent skill, or read its SKILL.md first: it has the rules that
make glass work (one host above the navigator, what the app declares, what costs a capture) and
links to every page below.

## Agent skill

- [SKILL.md](https://g1455.plugfox.dev/.well-known/agent-skills/g1455/SKILL.md): the skill itself
- [Install](https://g1455.plugfox.dev/start/agents.md): `npx skills add PlugFox/g1455`, or in Claude Code
  `/plugin marketplace add PlugFox/g1455` then `/plugin install g1455@g1455`
- [Discovery index](https://g1455.plugfox.dev/.well-known/agent-skills/index.json): `npx skills add https://g1455.plugfox.dev`

## Getting started

- [Installation](https://g1455.plugfox.dev/start/installation.md): Add the package, put one GlassHost above the navigator, and lay the first glass over content.
- [How it works](https://g1455.plugfox.dev/start/how-it-works.md): One host captures the backdrop once for every glass surface, only when something under the glass changed.
- [What the app declares](https://g1455.plugfox.dev/start/declarations.md): What the package cannot read from the render tree: the backdrop, reduce transparency, contrast, thermal state.
- [Platforms & web](https://g1455.plugfox.dev/start/platforms.md): The same glass on Impeller (Metal, Vulkan, GLES), on Skia, and on the web with CanvasKit and Skwasm.
- [AI agents](https://g1455.plugfox.dev/start/agents.md): An agent skill for Claude Code, Codex, Cursor, Antigravity, Gemini CLI and Copilot: the rules for writing glass, and every page of this site, installed with one command.

## Foundations

- [GlassHost](https://g1455.plugfox.dev/foundations/host.md): The engine room of a screen: one capture of the backdrop for all its glass, re-taken only when it changed.
- [GlassSurface](https://g1455.plugfox.dev/foundations/surface.md): The primitive: a box of the screen that is glass. It refracts, blurs and tints the backdrop, then paints its child.
- [Finishes](https://g1455.plugfox.dev/foundations/finishes.md): The material of the glass: regular dark and light, clear and frosted, calibrated against Apple's iOS 26 materials.
- [Legibility & theme](https://g1455.plugfox.dev/foundations/legibility.md): How glass components choose black or white labels, keep them readable, and how a subtree gets its own look.
- [Adaptive glass](https://g1455.plugfox.dev/foundations/adaptive.md): Glass that reads its own backdrop: a bar over a bright sky turns light, a button over a shadow stays dark, each with a label to match. Off by default and free when off.
- [Tiers & fallbacks](https://g1455.plugfox.dev/foundations/tiers.md): Full glass, a cheap translucent fill, or opaque: the rung for reduce transparency, low-end devices and tests.
- [Ripple](https://g1455.plugfox.dev/foundations/ripple.md): An optional liquid wave when glass is touched, from water to honey. Not an Apple behaviour, off under reduced motion, and it costs no capture.
- [Drop motion](https://g1455.plugfox.dev/foundations/drop-motion.md): The held drop of the switch, slider, segmented control and tab bar stretches as it sets off, squashes as it stops and springs back round. One spec for the app, or per control.
- [Groups & unions](https://g1455.plugfox.dev/foundations/groups.md): Draw several glass surfaces as one piece of liquid glass: GlassGroup fuses them when they come close, GlassUnion keeps them joined at any distance.
- [Travel](https://g1455.plugfox.dev/foundations/travel.md): Declare the region moving glass travels in, so a dragged lens or a sliding knob is redrawn from the capture the host already holds instead of triggering a new one.
- [Glass on glass](https://g1455.plugfox.dev/foundations/above.md): Glass inside other glass refracts it automatically. A bar floating over sibling glass, such as glass cards, needs GlassAbove to show them.
- [Capture control](https://g1455.plugfox.dev/foundations/capture.md): Tell the capture what a subtree is: paint a stand-in for a video or a platform view, leave a subtree out, mark an opaque cover, or keep a blur the shadow filter would drop.
- [Scroll edge](https://g1455.plugfox.dev/foundations/scroll-edge.md): iOS 26's scroll edge effect: content softly blurs and fades as it scrolls under a bar, or meets an opaque band. It also holds and lifts the bar.
- [Performance](https://g1455.plugfox.dev/foundations/performance.md): What glass costs and how to keep it cheap: surface count, button groups, travel regions, thermal state, and the ledger that reports the glass on screen.

## Components

- [Bar](https://g1455.plugfox.dev/components/bar.md): GlassBar is a floating glass capsule for navigation: a title bar, a bottom bar or a now-playing pill, with black or white labels picked for legibility.
- [Button](https://g1455.plugfox.dev/components/button.md): GlassButton is a tappable glass capsule that brightens while held, with a 44 × 44 minimum tap target and dimmed labels when disabled.
- [Card](https://g1455.plugfox.dev/components/card.md): GlassCard is a rounded glass panel for a few floating groups of content, such as widgets on a wallpaper, with a legible label colour for its children.
- [Switch](https://g1455.plugfox.dev/components/switch.md): GlassSwitch is the iOS 26 on/off switch: a white knob that lifts into a clear glass drop while you press or drag it, and costs nothing extra at rest.
- [Slider](https://g1455.plugfox.dev/components/slider.md): GlassSlider is a continuous 0 to 1 slider whose knob turns into a clear glass drop while you drag it, for volume, brightness or a scrubber.
- [Segmented control](https://g1455.plugfox.dev/components/segmented-control.md): GlassSegmentedControl picks one of two to five options. The selected segment lifts into a clear glass drop you can slide to another segment.
- [Tab bar](https://g1455.plugfox.dev/components/tab-bar.md): GlassTabBar is the floating iOS 26 tab bar. The selected tab lifts into a glass drop that magnifies the bar and can be dragged from tab to tab.
- [Text field](https://g1455.plugfox.dev/components/text-field.md): A single-line text field in its own glass capsule, like the search field of an iOS 26 bar. Text, placeholder and icons take a legible colour.
- [Toolbar](https://g1455.plugfox.dev/components/toolbar.md): Several toolbar actions in one glass capsule, the way iOS 26 groups toolbar items. One surface for any number of actions, so it costs far less than a row of buttons.
- [Alert](https://g1455.plugfox.dev/components/alert.md): iOS 26's alert on glass: a title, an optional message and capsule actions, shown over a dim with showGlassDialog. It materializes in, blur first and tint last.
- [Sheet](https://g1455.plugfox.dev/components/sheet.md): A floating glass bottom sheet with a grabber, inset from the screen edges. Drag it down or flick it to dismiss, and await the value it was closed with.
- [Menu](https://g1455.plugfox.dev/components/menu.md): iOS 26's pull-down menu: a glass list of actions that grows out of the button that opened it. Choosing a row runs it and closes the menu.
- [Popover](https://g1455.plugfox.dev/components/popover.md): A glass panel of any content that grows out of its anchor and stays open while it is used: for quick settings and filters changed in place.
- [Morph](https://g1455.plugfox.dev/components/morph.md): One piece of glass that flows to the size of whatever child it holds: a button that becomes a panel, with a liquid neck while it moves.
- [Scaffold](https://g1455.plugfox.dev/components/scaffold.md): GlassScaffold is a whole screen wired the recommended way: a top bar in a scroll edge, an optional bottom bar and floating action, and a body that scrolls under them.

## Optional

- [Every page in one file](https://g1455.plugfox.dev/llms-full.txt)
- [API reference](https://pub.dev/documentation/g1455/latest/g1455/)
- [Changelog](https://pub.dev/packages/g1455/changelog)
- [Source](https://github.com/PlugFox/g1455)