Complete User Flow

Tap any screen to see details · All major paths and branches included

01 Onboarding & Placement
02 Conversation Session
03 Post-Session Summary
04 Profile & Settings
Click any screen card for details
BRANCHConditional path
STATESame screen, different state
OPTIONALConditional appearance
01 · Onboarding
First Launch & Placement Check
New users assessed through a short spoken conversation. Zoe determines the level automatically โ€” no test, no quiz.
Start Screen
Start Screen
Zoe introduces herself ยท Speaks headline
Placement Check
Placement Check
Zoe chats to detect level
Input states
STATE
Mic Active
Mic Active
Waveform ยท Tap to stop
STATE
Keyboard Mode
Keyboard Mode
Text fallback ยท Secondary
Placement Result
Placement Result
Level revealed ยท Zoe encourages
Home Screen
Home Screen
Topic picker ยท Free-form option
02 · Conversation Session
The Core Loop
User picks a topic (or lets Zoe choose), has a free-form spoken conversation, and can end at any time.
Topic Selected
Topic Selected
Or "Talk to Zoe" free-form
Conversation states
Conversation
Conversation
Zoe speaks ยท Mic dominant
STATE
Captions Off
Captions Off
Audio-only mode ยท Toggle
End Confirmation
End Confirmation
Bottom sheet ยท Guards accidental exit
Nothing spoken
BRANCH
No Conversation
No Conversation
Try Again or Pick New Topic
Conversation happened
BRANCH
Great Conversation
Great Conversation
5+ turns ยท Full summary
BRANCH
Good Effort
Good Effort
Some exchange ยท Warm tone
BRANCH
Every Session Counts
Every Session Counts
1โ€“4 turns ยท Habit focus
03 · Post-Session
Summary & Next Steps
After a session, users can review the transcript and (on first session at B1+) set coaching preferences.
Session Summary
Session Summary
Any end screen with conversation
Optional from summary
OPTIONAL
Full Transcript
Full Transcript
Bottom sheet ยท Review full chat
OPTIONAL
Focus Areas Nudge
Focus Areas Nudge
First session ยท B1+ only
Pick New Topic
Pick New Topic
Back to home ยท Loop restarts
04 · Profile & Settings
User Info & Coaching Preferences
Access via top-right icon on home screen. Focus areas section hidden from A1โ€“A2 users.
Home Screen
Home Screen
Profile icon ยท Top-right
Profile
Profile
Level ยท Info ยท Coaching style
Profile actions
Edit Profile
Edit Profile
Bottom sheet ยท Name, age, location
B1+ ONLY
Focus Areas
Focus Areas
B1+ only ยท Grammar / Vocab / Fluency
๐Ÿ’ฌ Comments & Suggestions

Have feedback on the design? Drop a comment below โ€” it'll be saved as a GitHub Issue on the repo so the team can track it. You'll need a GitHub account to comment.