---
title: "S07 Onboarding · Notification priming"
description: "Contract, a board per state (default, loading, empty, error, offline), tokens and strings."
source: "design/hifi/S07/screen.md"
---

> Part of [Brand and design](/design/llms.txt). Every page: [llms.txt](/llms.txt).

# Hi-fi: S07 Onboarding · Notification priming

> Generated by `botgumi-design index` from `../../screens.json`. Edit that file, not this page.

Stage: **hifi** · Key: `onboarding/notification-priming` · Data-binding map: [bindings.md](/design/hifi/s07/bindings/index.md)

Drawn in the gallery: [Onboarding](/design/gallery/index.html#g-onboarding). Each board is the committed HTML in `screens/`, drawn on the example data in `docs/api/examples/`.

## Contract

- **default**: Pre-permission screen before the system prompt. Either button submits POST /v1/onboarding; 'Turn on' then triggers the iOS prompt.

Flows: F1 First launch → diagnostic → paywall → first real session.

Reads and calls:

- `POST /v1/onboarding (OnboardingAnswers incl. practice_language)`
- `PUT /v1/me/push-token (if granted)`
- `PATCH /v1/me {settings.reminders_enabled}`

Local state:

- none

## Boards

One row per state. A state without boards of its own says what shows it.

| State | Board | Example data |
|---|---|---|
| default | [zh-Hans](/design/gallery/onboarding/notification-priming--default.html) · [en](/design/gallery/onboarding/notification-priming--default.en.html) | onboarding-answers.json ([zh-Hans](/design/examples/zh-Hans/onboarding-answers.json) · [en](/design/examples/en/onboarding-answers.json)) |
| loading | [no board of its own](/design/hifi/s07/bindings/index.md#states): From [states.md](/design/states/index.md) (Onboarding (6 steps)): n/a (local) |  |
| empty | [no board of its own](/design/hifi/s07/bindings/index.md#states): From [states.md](/design/states/index.md) (Onboarding (6 steps)): n/a |  |
| error | [no board of its own](/design/hifi/s07/bindings/index.md#states): From [states.md](/design/states/index.md) (Onboarding (6 steps)): `POST /onboarding` failed: inline banner + Retry; answers kept · fatal: generic error, answers kept |  |
| offline | [no board of its own](/design/hifi/s07/bindings/index.md#states): From [states.md](/design/states/index.md) (Onboarding (6 steps)): answers kept; submit queued; diagnostic needs network → "Connect to start your diagnostic" |  |

### The boards

Each state as drawn (393 × 852), one board per locale. Open a board on its own for its spec panel.

**default**

[S07 default · zh-Hans](/design/gallery/onboarding/notification-priming--default.html) [S07 default · en](/design/gallery/onboarding/notification-priming--default.en.html)

## Tokens used

By path in `../../system/tokens.source.json`.

| Token | Where |
|---|---|
| `color.accentPrimary` | `.btn--primary` |
| `color.accentPrimaryPressed` | `.btn--primary` |
| `color.bgCanvas` | `.device`, `.dock`, `.screen` |
| `color.bgInverse` | `.brand-mark` |
| `color.bgInverseRaised` | `.icon-btn` |
| `color.bgSunken` | `.btn`, `.icon-btn`, `inline` |
| `color.bgSurface` | `.card`, `inline` |
| `color.lineHairline` | `.ob-progress` |
| `color.statusSuccess` | `.on` |
| `color.textDisabled` | `.btn` |
| `color.textOnAccent` | `.btn--primary` |
| `color.textOnInverse` | `.brand-mark`, `.icon-btn` |
| `color.textPrimary` | `.device`, `.home-indicator`, `.icon-btn`, `.ob-progress` … |
| `color.textSecondary` | `.btn--ghost`, `.c-secondary` |
| `color.textTertiary` | `.c-tertiary`, `.step-count` |
| `radius.button` | `.btn` |
| `radius.card` | `.card` |
| `space.gutter` | `.dock`, `.ob-progress`, `.pad` |
| `space.s5` | `.card` |
| `space.s6` | `.screen` |
| `space.safeBottom` | `.dock`, `.dock-tall`, `.has-dock`, `.screen` |
| `space.safeTop` | `.device`, `.screen` |
| `space.sizeCtaHeight` | `.btn`, `.dock-tall`, `.has-dock`, `.screen` |
| `space.sizeHitMin` | `.btn--ghost`, `.icon-btn` |
| `space.sizeTabbarHeight` | `.screen` |
| `typography.callout` | `.t-callout` |
| `typography.caption1` | `.t-caption` |
| `typography.subheadline` | `.t-subhead` |
| `typography.title1` | `.t-title1` |

## Strings

`app.name`, `common.back`, `common.later`, `common.step_of.a11y`, `common.today`, `mic_sheet.skip`, `notif.daily.body`, `notif.daily.title`, `onboarding.notify.allow`, `onboarding.notify.point1`, `onboarding.notify.point2`, `onboarding.notify.point3`, `onboarding.notify.preview.a11y`, `onboarding.notify.subtitle`, `onboarding.notify.title`, `onboarding.progress.a11y`, `paywall.calendar.legend.today`, `paywall.projection.score`, `processing.unreliable.reason_label`, `profile.settings`, `profile.settings.a11y`, `read.tag.daily`, `settings.nav`

## Notes for the app tracks

Motion, haptics, Dynamic Type and VoiceOver: [engagement.md](/design/engagement/index.md), [tokens.md](/design/tokens/index.md) §6–7 and
[ios-handoff.md](/design/ios-handoff/index.md). Open a board with `?theme=dark&dt=1.35&binds=1` to see dark mode, the largest
tested type size and every bound element.

Tracking-plan events: no tracking plan page exists yet; ADR-001 D12 names the events.

Tokens with no group in `system/tokens.source.json` yet (they stay in [tokens.css](/design/tokens.css)): `--dt`, `--elevation-1`, `--font-family-numeric`, `--font-family-text`, `--font-weight-bold`, `--font-weight-medium`, `--font-weight-regular`, `--font-weight-semibold`, `--motion-duration-fast`, `--motion-duration-instant`, `--motion-ease-standard`, `--type-tracking-tight`.