> ## Documentation Index
> Fetch the complete documentation index at: https://design.slingshotai.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This site documents Sundial 2.0, the design system of the Ash mobile app (Flutter). For implementing UI: use the Design System pages — color/typography tokens (foundations/*), Flutter theming (theming/*), and component APIs (components/*) — as your reference; every value there mirrors the Dart source in lib/design_system/. The Philosophy pages (philosophy/*) are design rationale written for humans: consult them when making design decisions, not for API lookups. Golden rules: never hardcode colors or text styles — read tokens via context.colorTheme and context.textTheme; prefer the 2.0 semantic names (contentPrimary, surfaceComponent, accentSolid…) over legacy contrast*/surface* getters and over SundialRef primitives; the accent is a single pale lavender solid that takes dark content — never use accent fills as text, icons, or borders (use contentAccent / borderSelected); brand surfaces are mode-invariant and pair with the contentOnBrand* inks; check lib/design_system/components/ before building custom widgets.

# Changelog

> Version history of the Sundial design system — every meaningful change to tokens, components, and theming

Sundial is versioned as a system: the version reflects the design system as it ships in the Ash app, not this documentation site. Entries below are backfilled from the git history of [`lib/design_system/`](https://github.com/slingshot-ai/ash-mobile-app/tree/main/lib/design_system) and reference their pull requests. Bump rules live in [Contributing](https://design.slingshotai.com/patterns/contributing.md#versioning--changelog).

**October 9, 2026**

Periwinkle

## The accent moves to periwinkle

The brand lead and accent change from Lavender Blue `#CDCCF0` to **Periwinkle `#DBE1FD`** ([#1968](https://github.com/slingshot-ai/ash-mobile-app/pull/1968), in review). Both [lavender ramps](https://design.slingshotai.com/foundations/colors/reference.md#lavender) were re-derived from that single anchor in OKLCH: hue rotated −10.6°, chroma eased near the anchor and kept full on the deep steps, lightness held so every step keeps its contrast.

Token changes in the same release:

* [`contentOnAccent`](https://design.slingshotai.com/foundations/colors/semantic#content) / `accent.onButton` is now **pure black** (16.2:1 on the solid).
* Light-mode [`contentAccent`](https://design.slingshotai.com/foundations/colors/semantic#content) / `accent.secondary` moves to lavender step 12 — step 11 read royal blue as text.
* New [`accentLine`](https://design.slingshotai.com/foundations/colors/semantic) (light 8 / dark 11) for accent outlines, checkboxes and progress: 3:1, never text.
* `brandLavender` follows step 9, along with the native splash screens and the production app icon.

This site was rethemed to the new values.

**August 7, 2026**

Sundial 2.0

## Sundial 2.0 color system

The color foundations are rewritten for **Sundial 2.0**: warm sand 12-step scales on the Radix model with paired alpha inks, the single Lavender Blue accent on a bright-solid grammar (a pale solid that takes dark content), eight mode-invariant brand flats, and cherry/amber status stops. Personas are retired — [Accent Theming](https://design.slingshotai.com/theming/persona-theming.md) documents the replacement, and [ThemeOverride](https://design.slingshotai.com/components/theme-override.md) is brightness-only.

New in the token set: [`contentOnBrandSecondary`](https://design.slingshotai.com/foundations/colors/semantic#content) — the secondary tier on brand surfaces, an alpha ink (light-alpha step 11) so the surface supplies the hue and one token holds AA on every brand color.

Rollout status: the token system is fully specified in Figma and implemented behind draft PRs [#1435](https://github.com/slingshot-ai/ash-mobile-app/pull/1435)–[#1439](https://github.com/slingshot-ai/ash-mobile-app/pull/1439); the old brand flats already resolve to 2.0 values in place. Legacy semantic names survive as forwarding getters until the rename phase completes.

This site was rethemed to the 2.0 values: warm sand near-black canvas, lavender ramp accents.

**July 29, 2026**

Wallpapers

## Pattern wallpapers retired

The last five surfaces still backed by hand-drawn pattern PNGs — the notification preview, onboarding notifications, the force-update modal, the voice-migration modal, and the shared interstitial modal header — now use a flat `SolidWallpaper(ReferenceColors.lavender)` ([#1412](https://github.com/slingshot-ai/ash-mobile-app/pull/1412)). `interstitialModalHeader` lost its `image:` parameter along the way.

With no callers left, `ImageWallpaper.pattern`, `ImageWallpaper.random`, and the 26-image pattern bank were deleted ([#1413](https://github.com/slingshot-ai/ash-mobile-app/pull/1413)). This completes the move to flat brand color that [`SolidWallpaper`](https://design.slingshotai.com/foundations/wallpapers#solidwallpaper) began in June 2026.

[`ImageWallpaper`](https://design.slingshotai.com/foundations/wallpapers#imagewallpaper) remains, narrowed to server-supplied imagery — a single URL, one use in the app. Use `SolidWallpaper` for decorative backgrounds.

**July 24, 2026**

Brand

## Brand section illustrated, site rethemed

The [Brand](https://design.slingshotai.com/brand/overview.md) section now carries the artwork of the Ash Brand Book: 19 slides exported from the [book's Figma](https://www.figma.com/design/DUpdqWp9T9djLnWo0Op0yk/Brand-Book) across all seven pages — cover, marks, type specimens, illustration system, voice treatment, and applications. [Color](https://design.slingshotai.com/brand/color.md) gained the new palette as native swatches (core, beiges, the Lavender Blue lead, and the green/orange/yellow pastels, sampled from the book's chips) plus a "How we got here" retrospective.

This site was rethemed to match the brand direction, locked to dark: Lavender Blue accent and a warm near-black background in place of the persona plum and grid decoration.

**July 23, 2026**

Components

## StyledIconButton joins the system

The single-pill conversation input bar redesign ([#1376](https://github.com/slingshot-ai/ash-mobile-app/pull/1376)) introduced [`StyledIconButton`](https://design.slingshotai.com/components/styled-icon-button) — a 40 px circular icon button with `.accent` and `.surface` variants and a `showDisabledColors` mode for buttons that look unavailable but stay tappable to explain why.

**July 14, 2026**

v1.0.0

## Sundial 1.0

Sundial is declared **1.0**: the system as documented on this site, shipping in the Ash app today.

The 1.0 snapshot:

* **Three-layer color tokens** — 9 reference ramps + 7 brand colors, 25 semantic tokens with light/dark mappings, 5 persona accent palettes
* **15 typography tokens** — Libertinus Serif display styles + Inter (variable weight, incl. the 425 body weight)
* **14 components** — Styled\* Material wrappers and Ash\* brand primitives
* **Theming** — ThemeExtension delivery, context accessors, the Material bridge, subtree persona overrides

Also in this release: this documentation site — full token/component reference, Flutter theming guides, the design [Philosophy](https://design.slingshotai.com/philosophy/overview.md) section, and this changelog.

**June 23, 2026**

Accessibility

## Screen reader support in core flows

VoiceOver/TalkBack support added across core flows ([#1262](https://github.com/slingshot-ai/ash-mobile-app/pull/1262)). For the design system this established the accessibility conventions documented in [Conventions](https://design.slingshotai.com/patterns/conventions.md#accessibility):

* [`SemanticButton`](https://design.slingshotai.com/components/semantic-button) — composite tappables merge into a single announced button
* Decorative-by-default icons (`semanticLabel: null` on [`AshIcon`](https://design.slingshotai.com/components/ash-icon)), labeling at the button layer

**June 18, 2026**

Wallpapers

## Flat brand colors replace gradient wallpapers

Gradient wallpapers were replaced with flat brand colors ([#1283](https://github.com/slingshot-ai/ash-mobile-app/pull/1283)), introducing [`SolidWallpaper`](https://design.slingshotai.com/foundations/wallpapers#solidwallpaper) with its `cardPalette`/`brandPalette` and the `forWeekday`/`brand`/`forSeed` factories — and with it the solid-wallpaper legibility rule (dark text, no scrim).

**June 12, 2026**

Typography

## Typography aligned to the Parchment spec

Typography tokens and fonts updated to match the Parchment spec ([#1269](https://github.com/slingshot-ai/ash-mobile-app/pull/1269)): **Inter** (variable weight via `FontVariation`, including the 425 body weight) and **Libertinus Serif** for display styles. Display styles set to 100% line height ([#1270](https://github.com/slingshot-ai/ash-mobile-app/pull/1270)). The chat FAB was aligned to its Figma spec the same day ([#1267](https://github.com/slingshot-ai/ash-mobile-app/pull/1267)).

Current spec: [Typography](https://design.slingshotai.com/foundations/typography.md).

**April 11, 2026**

Iconography

## Icons optimized for server-driven UI

The icon system was optimized for SDUI ([#1155](https://github.com/slingshot-ai/ash-mobile-app/pull/1155)) — the era of [`AshIcon.network`](https://design.slingshotai.com/components/ash-icon) for server-delivered SVGs alongside the registered `AshIcons` enum.

**March 3, 2026**

Interaction

## Haptic feedback on navigation

Bottom-navigation destinations and home-screen cards gained haptic feedback ([#1102](https://github.com/slingshot-ai/ash-mobile-app/pull/1102)) — now a built-in behavior of [`NavDestination`](https://design.slingshotai.com/components/styled-navigation-bar) (`HapticFeedback.selectionClick()` before `onTap`).

**February 18, 2026**

Components

## Navigation components join the system

Following the app-navigation overhaul ([#1044](https://github.com/slingshot-ai/ash-mobile-app/pull/1044)), the navigation bar and FAB were moved into the design system ([#1049](https://github.com/slingshot-ai/ash-mobile-app/pull/1049)) as [`StyledNavigationBar`](https://design.slingshotai.com/components/styled-navigation-bar) + `NavDestination` and [`StyledFloatingActionButton`](https://design.slingshotai.com/components/styled-floating-action-button).

**January 16, 2026**

Sundial is born

## Initial Sundial implementation

The Sundial Design System landed in the Ash app ([#985](https://github.com/slingshot-ai/ash-mobile-app/pull/985)):

* **ReferenceColors** primitive ramps and **DesignSystemColors** semantic tokens as Flutter `ThemeExtension`s
* **DesignSystemTypography** — the 5×3 token grid
* **AccentColors** with the five persona palettes
* `AppTheme` building light/dark `ThemeData` with every Material component themed
* The first `Styled*` components and `context.colorTheme` / `context.textTheme` accessors


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.