Brand and design · Stages
Screens: Shuke
Stage 3: every screen with its ID, states, flows and stage. The contract of what exists.
Generated by
botgumi-design indexfrom../screens.json. Edit that file, not this page.
Every screen, its states and flows (botgumi ADR-0004, ADR-0006). A screen that is not in this list is not built.
Prototype: screens/index.html
Screens
Stage: lofi, then hifi when its hi-fi boards are drawn, then approved with its gate issue.
| ID | Screen | States | Flows | Stage | Gate |
|---|---|---|---|---|---|
| S01 | Onboarding · Welcome (onboarding/welcome) |
default, loading, empty, error, offline | F1 | hifi | |
| S02 | Onboarding · Practice language (onboarding/language) |
selected, loading, empty, error, offline | F1 | hifi | |
| S03 | Onboarding · Goal (onboarding/goal) |
default, selected, loading, empty, error, offline | F1 | hifi | |
| S04 | Onboarding · Scenario + topics (onboarding/scenario) |
default, selected, loading, empty, error, offline | F1 | hifi | |
| S05 | Onboarding · Self-assessed level (onboarding/self-level) |
default, selected, loading, empty, error, offline | F1 | hifi | |
| S06 | Onboarding · Weekly days + reminder time (onboarding/commitment) |
default, selected, loading, empty, error, offline | F1 | hifi | |
| S07 | Onboarding · Notification priming (onboarding/notification-priming) |
default, loading, empty, error, offline | F1 | hifi | |
| S08 | Diagnostic · Diagnostic · intro (diagnostic/diag-intro) |
default, loading, empty, error, offline | F1 | hifi | |
| S09 | Diagnostic · Diagnostic · read (diagnostic/diag-read) |
normal, loading, empty, error, offline | F1 | hifi | |
| S10 | Diagnostic · Mic purpose sheet (pre-permission) (diagnostic/mic-purpose) |
sheet, loading, empty, error, offline | F1, F5 | hifi | |
| S11 | Diagnostic · Diagnostic · retell (diagnostic/diag-record) |
idle, recording, paused, autostop, too-short, permission-denied, loading, empty, error, offline | F1 | hifi | |
| S12 | Diagnostic · Diagnostic · processing (diagnostic/diag-processing) |
uploading, transcribing, assessing, failed, unreliable, loading, empty, error, offline | F1 | hifi | |
| S13 | Diagnostic · Diagnostic result · animated reveal (diagnostic/diag-result) |
reveal, loading, empty, error, offline | F1 | hifi | |
| S14 | Plan · 14-day plan (plan/plan) |
default, loading, empty, error, offline | F1 | hifi | |
| S15 | Paywall · Paywall (paywall/paywall) |
default, loading-products, purchasing, purchase-failed, restored, expired-return, loading, empty, error, offline | F1, F7 | hifi | |
| S16 | Home · Home (home/home) |
first-time, normal, in-progress, completed, streak-risk, offline, no-quest, topic-empty, loading, error, empty | F1, F2, F4 | hifi | |
| S17 | Library · Library (library/library) |
loading, list, language-en, filtered, filter-empty, error, empty, offline | F3 | hifi | |
| S18 | Read · Read (read/read) |
normal, long-scroll, dynamic-type-xl, loading, empty, error, offline | F1, F2, F4 | hifi | |
| S19 | Record · Retell · round 1 (record/record) |
idle, recording, paused, autostop, too-short, permission-denied, interrupted, loading, empty, error, offline | F2, F4, F5 | hifi | |
| S20 | Processing · Processing (processing/processing) |
uploading, transcribing, assessing, failed, unreliable, long-wait, offline, loading, empty, error | F2, F4, F6 | hifi | |
| S21 | Feedback · Feedback (feedback/feedback) |
full, low-confidence, achieved, playback, exemplar-pending, exemplar-failed, loading, empty, error, offline | F2 | hifi | |
| S22 | Compress · Second take · round 2 (compress/compress) |
idle, recording, paused, autostop, too-short, permission-denied, interrupted, loading, empty, error, offline | F2 | hifi | |
| S23 | Complete · Complete (complete/complete) |
improved, same, shorter-lost, level-up, achievement, replayed, loading, empty, error, offline | F2, F4 | hifi | |
| S24 | Growth · Growth (growth/growth) |
empty, baseline, ready, gap, loading, error, offline | F2 | hifi | |
| S25 | Profile · Me · anonymous user (profile/profile) |
normal, loading, empty, error, offline | hifi | ||
| S26 | Profile · This week's quests (profile/weekly-quests) |
default, loading, empty, error, offline | hifi | ||
| S27 | Profile · Settings (profile/settings) |
default, language, delete-data-confirm, delete-account-confirm, loading, empty, error, offline | F8, F9 | hifi | |
| S28 | Profile · Sign in with Apple upgrade (profile/siwa) |
sheet, loading, empty, error, offline | hifi | ||
| S29 | Profile · Privacy & AI disclosure (profile/privacy) |
default, loading, empty, error, offline | hifi | ||
| S30 | Global · Resume session (global/resume-session) |
sheet, loading, empty, error, offline | F4 | hifi | |
| S31 | Global · Leave recording confirm (global/leave-recording) |
alert, loading, empty, error, offline | hifi | ||
| S32 | Global · Offline toast (global/offline) |
toast, loading, empty, error, offline | F6 | hifi | |
| S33 | Global · Generic error (global/error) |
generic, loading, empty, error, offline | hifi | ||
| S34 | Global · Force update (global/force-update) |
default, loading, empty, error, offline | F1 | hifi |
Flows
- F1 First launch → diagnostic → paywall → first real session: S34 → S01 → S02 → S03 → S04 → S05 → S06 → S07 → S08 → S09 → S11 → S10 → S12 → S13 → S14 → S15 → S16 → S18
- F2 Daily quest: S16 → S18 → S19 → S20 → S21 → S22 → S23 → S24
- F3 Free practice from the library: S17
- F4 Resume after the app was killed: S30 → S18 → S19 → S20 → S23 → S16
- F5 Microphone permission denied: S10 → S19
- F6 Offline mid-upload: S20 → S32
- F7 Expired subscription: S15
- F8 Delete training data / account: S27
- F9 Change UI language / practice languages: S27
Open questions
- Every screen is at
hifi: the gallery was drawn before the botgumi gates existed, so the retroactive hi-fi gates (one issue per flow,docs/checklists/design-gates.md) are pending. - Required states without a board of their own follow the shared patterns in states.md; a gate may ask for a board.
- Contract change requests CCR-1 to CCR-13 in data-binding.md are applied; a field that still waits on one is
pending(botgumi ADR-0006 D2).