Brand and design · Hi-fi screens · Hi-fi screens
Hi-fi: S02 Onboarding · Practice language
Contract, a board per state (selected, loading, empty, error, offline), tokens and strings.
Generated by
botgumi-design indexfrom../../screens.json. Edit that file, not this page.
Stage: hifi · Key: onboarding/language · 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
- selected: NEW (D13). Default = device locale, pre-selected. Sets OnboardingAnswers.practice_language; the diagnostic article is in this language. UI language is separate (follows the device, changeable in Settings).
Flows: F1 First launch → diagnostic → paywall → first real session.
Reads and calls:
GET /v1/config → supported_practice_languages
Local state:
local:onboarding.answers.practice_language
Boards
One row per state. A state without boards of its own says what shows it.
| State | Board | Example data |
|---|---|---|
| selected | 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.
selected
Tokens used
By path in ../../system/tokens.source.json.
| Token | Where |
|---|---|
color.accentPrimary |
.btn--primary |
color.accentPrimaryPressed |
.btn--primary |
color.bgCanvas |
.device, .dock, .option, .radio … |
color.bgInverse |
.opt-icon, .option |
color.bgInverseRaised |
.icon-btn |
color.bgSunken |
.btn, .icon-btn, .opt-icon, .option |
color.bgSurface |
.option |
color.lineHairline |
.ob-progress, .option |
color.lineStrong |
.option, .radio |
color.statusSuccess |
.on |
color.textDisabled |
.btn |
color.textOnAccent |
.btn--primary |
color.textOnInverse |
.icon-btn, .opt-icon, .option |
color.textPrimary |
.device, .home-indicator, .icon-btn, .ob-progress … |
color.textSecondary |
.c-secondary |
color.textTertiary |
.c-tertiary, .step-count |
radius.button |
.btn |
radius.md |
.option |
space.gutter |
.dock, .ob-progress, .pad |
space.s6 |
.screen |
space.safeBottom |
.dock, .has-dock, .screen |
space.safeTop |
.device, .screen |
space.sizeCtaHeight |
.btn, .has-dock, .screen |
space.sizeHitMin |
.icon-btn |
space.sizeTabbarHeight |
.screen |
typography.footnote |
.t-footnote |
typography.headline |
.t-headline |
typography.subheadline |
.t-subhead |
typography.title1 |
.t-title1 |
Strings
app.name, common.back, common.continue, common.step_of.a11y, feedback.confidence.low, lang.en, lang.zh-Hans, notif.daily.title, onboarding.language.en.sub, onboarding.language.subtitle, onboarding.language.title, onboarding.language.ui_note, onboarding.language.zh-Hans.sub, onboarding.progress.a11y, paywall.projection.score, profile.settings, profile.settings.a11y, read.nav, resume.cta, settings.nav, tab.library
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, --font-family-numeric, --font-family-text, --font-weight-bold, --font-weight-regular, --font-weight-semibold, --motion-duration-fast, --motion-duration-instant, --motion-ease-spring, --motion-ease-standard, --type-tracking-tight.