Wallpapers

Wallpapers are Sundial’s decorative background system — used behind cards, list tiles, and hero surfaces. The model is a sealed class hierarchy in components/ash_wallpaper.dart rendered by the AshWallpaper widget:

sealed class Wallpaper {}

class SolidWallpaper implements Wallpaper { … }   // flat brand color
class ImageWallpaper implements Wallpaper { … }   // remote image by URL
class VectorWallpaper implements Wallpaper { … }  // gradient "blobs"

SolidWallpaper

A flat, single-color wallpaper built on the brand colors. Introduced to replace gradients with solid brand colors as part of removing gradients from the app. Palettes:

Palette	Colors	Used by
`cardPalette`	orange, lavender, sky, grass, sunflower	Conversation-starter cards, weekly insights
`brandPalette`	cardPalette + tomato, rock	Full cycling/seeding set

Factories:

// Fixed color
SolidWallpaper(ReferenceColors.sky)

// One brand color per weekday (Mon=sky, Tue=lavender, Wed=grass,
// Thu=sunflower, Fri=orange, Sat=tomato, Sun=rock)
SolidWallpaper.forWeekday(DateTime.now().weekday)

// Cycle through brandPalette by index — lists of cards
SolidWallpaper.brand(index)

// Deterministic pick from a seed — same entity, same color every time
SolidWallpaper.forSeed(weekNumber, palette: SolidWallpaper.cardPalette)

ImageWallpaper

A single remote image by URL, cached via cached_network_image. Reach for it only when the artwork is supplied by the backend — it’s the one wallpaper type whose content isn’t decided in code.

ImageWallpaper(imageSrc: 'https://…/header.png')

Props: imageSrc (required), scale (default 1.0), alignment (default center), fadeInDuration (default 500 ms). While loading (or on error) the wallpaper shows a surfaceBg placeholder. It has exactly one use in the app today: the feature intro modal header, whose image URL arrives from the server.

The pattern bank is gone (July 29, 2026). ImageWallpaper used to also serve a bank of 26 hand-drawn pattern PNGs through .pattern(image:) and .random(random:) factories. The five surfaces still on those patterns moved to SolidWallpaper(ReferenceColors.lavender) (#1412), then both factories and the pattern-bank plumbing were deleted (#1413).For a decorative brand background, use SolidWallpaper — don’t reintroduce a remote image for decoration.

VectorWallpaper

Blurred gradient “blobs” over a background color — the most atmospheric option. Each named constructor is a fruit/persona theme with a bgColor and three blob colors whose positions/sizes are deterministically randomized from a string seed:

Constructor	Background	Blobs
`.home()`	`CA57F4`	3 × `8B0CAE`
`.apple()`	`5DB996`	3 × `118B50`
`.blackberry()`	`4227B9`	3 × `A546F3`
`.blueberry()`	`0A0E86`	`2C6FD9187BCC0B71D1`
`.cherry()`	`860A19`	`C22CD9D40F6BD10BB3`
`.dragonfruit()`	`FDD7EF`	3 × `FC2BAC`
`.grape()`	`8D68FD`	`DC96E8D44DE0F85BF0`
`.orange()`	`FF5F00`	3 × `FF9F66`
`.peach()`	`FDDF68`	`FC7D58FF7C24FCC358`
`.pear()`	`C0C000`	`97B61B8ADA00FBEA51`
`.plum()`	`49243E`	3 × `704264`

home

apple

blackberry

blueberry

cherry

dragonfruit

grape

orange

peach

pear

plum

(Approximate CSS previews — the app renders soft blurred blobs at deterministic seeded positions.) VectorWallpaper.lerp(a, b, t) interpolates two vector wallpapers — background color and each blob — enabling animated wallpaper transitions.

Vector wallpaper colors are intentionally off-token — vivid one-off values for atmosphere, not part of the reference ramps.

Legibility rule

Content over a wallpaper must stay readable. The convention (implemented in StyledListTile):

Solid wallpapers — dark sand-12 ink (contentOnBrand), no scrim; the brand colors are light enough. Secondary lines take contentOnBrandSecondary, the alpha ink.
Image/vector wallpapers — force a dark-brightness subtree via ThemeOverride and add a bottom gradient scrim, so light text sits on a darkened backdrop.

The AshWallpaper widget’s default scrim is surfaceBg at 50% alpha; pass a custom scrim (or blur) as needed. See AshWallpaper for the rendering API.

Getting Started

Craft and Foundations

Brand

Design System

For Agents

SolidWallpaper

ImageWallpaper

VectorWallpaper

Legibility rule