Brand and design · Hi-fi screens · Hi-fi screens

Hi-fi: S07 Onboarding · Notification priming

Contract, a board per state (default, loading, empty, error, offline), tokens and strings.

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

Drawn in the gallery: 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 · en onboarding-answers.json (zh-Hans · en)
loading no board of its own: From states.md (Onboarding (6 steps)): n/a (local)
empty no board of its own: From states.md (Onboarding (6 steps)): n/a
error no board of its own: From states.md (Onboarding (6 steps)): POST /onboarding failed: inline banner + Retry; answers kept · fatal: generic error, answers kept
offline no board of its own: From states.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

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, tokens.md §6–7 and ios-handoff.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): --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.