AshWallpaper - Design

The rendering widget for the wallpaper system: give it any Wallpaper (solid, image, or vector) and it paints the background, a legibility scrim, and your content in a Stack. Source: ash_wallpaper.dart.

AshWallpaper(
  SolidWallpaper.forSeed(entityId.hashCode),
  child: Padding(
    padding: EdgeInsets.all(16),
    child: content,
  ),
)

API

Parameter	Type	Default	Notes
`wallpaper`	`Wallpaper`	required (positional)	`SolidWallpaper`, `ImageWallpaper`, or `VectorWallpaper`
`scrim`	`Widget?`	`surfaceBg` @ 50% alpha	Layer between wallpaper and child; pass `SizedBox.shrink()` for none
`fit`	`BoxFit?`	`BoxFit.none` (image) / `BoxFit.cover` (vector)	How the artwork fills the area
`blur`	`double`	`0`	When > 0, the scrim is wrapped in a `BackdropFilter` gaussian blur (mirror tiling)
`child`	`Widget?`	—	Foreground content

Layer order

┌─ child (optional) ───────────┐   top
├─ scrim (+ optional blur) ───┤
└─ wallpaper ─────────────────┘   bottom

Dispatch by type: SolidWallpaper → ColoredBox; ImageWallpaper → cached network image (with surfaceBg placeholder/error states); VectorWallpaper → blurred gradient-blob painter. The stack clips with Clip.hardEdge — give the parent the border radius (as StyledListTile does).

Legibility

The default 50% surfaceBg scrim is a reasonable general-purpose wash. For content-bearing surfaces follow the legibility rule: dark text with no scrim over solids; ThemeOverride(brightness: dark) + gradient scrim over textures.

Tokens consumed

surfaceBg (default scrim, image placeholder).