kalei/docs/product/kalei-complete-user-journey.md

Kalei — Complete User Journey Map

Version 2.0 — February 2026 Updated to include Ritual, Rehearsal, Evidence Wall, and full cross-feature integration

---

Overview

This document maps every user-facing flow in Kalei from first launch to long-term mastery. It serves as the single source of truth for what the user experiences, when, and why — covering all 7 features across the 5-tab architecture.

Navigation Architecture: Turn ◇ | Mirror ✦ | Lens ◎ | Gallery ▦ | You ●

Core Features (4 Pillars):

• The Turn (Kaleidoscope) — Perspective shifting via cognitive reframing
• The Mirror — Awareness through freeform journaling with AI fragment detection
• The Lens — Direction through goal setting, visualization, and action planning
• Gallery — Pattern collection and history

Connector Features (4 Bridges):

• The Ritual — Context-anchored daily habit sequences chaining Mirror → Turn → Lens
• The Rehearsal — Guided multi-sensory visualization (Lens sub-feature)
• The Evidence Wall — Mastery tracking mosaic (You tab sub-feature)
• The Guide — Active coaching layer connecting all features with proactive check-ins, cross-feature bridges, attention prompts, evidence interventions, and weekly pulse

Intelligence Layer:

• The Spectrum — AI-powered self-knowledge dashboard

---

Journey Stage 1: First Launch & Onboarding

Screen 1: Splash

• Breathing logo animation (soft-elegance iris, slow rotation, core pulse)
• Background: Void (#050508) with subtle breathing aura
• Duration: 2 seconds, auto-advance

Screen 2: Welcome — "Same pieces. New angle."

• Hero kaleidoscope pattern (6-blade prismatic, screen blend mode)
• Tagline in Space Grotesk display font
• Single CTA: "See how it works" (Amethyst shimmer button)

Screen 3: The Metaphor — Fragment Introduction

• Visual: A single thought fragment (◇) appears, glowing Amber
• Copy: "Your thoughts are like pieces of glass in a kaleidoscope."
• Interaction: User taps the fragment → it pulses with detected-state animation
• Copy continues: "Sometimes you see sharp edges. Sometimes beautiful patterns."

Screen 4: The Turn Demo — Live Reframe

• Pre-populated negative thought: "I always mess everything up"
• Auto-animated Turn sequence (1.5s): collapse → multiply → crystallize → settle
• Three reframed perspectives appear as jewel-toned cards (Amethyst, Sapphire, Emerald)
• Copy: "Same pieces. New angle. That's a Turn."

Screen 5: Choose Your Style

• 4 coaching style cards with fragment icons:
  • Stoic Sage (Sapphire ◇) — "Clear-eyed perspective"
  • Compassionate Friend (Rose ◇) — "Gentle understanding"
  • Pragmatic Coach (Emerald ◇) — "Practical next steps"
  • Growth Catalyst (Amber ◇) — "Opportunity in everything"
• User selects default (can change later)

Screen 6: Notification Permission

• Copy: "When would you like a gentle nudge to check in?"
• Time picker with morning/evening presets
• Skip option available

Screen 7: Account Creation

• Email + password OR Apple/Google SSO
• Minimal fields — name optional at this stage
• Privacy assurance: "Your thoughts stay yours. Always encrypted."

Screen 8: First Real Turn

• Empty Turn input with prompt: "What's weighing on you right now?"
• User types their first real negative thought
• Full Turn animation plays
• 3 reframed perspectives appear
• User can save favorites (→ Gallery) or dismiss
• Success burst animation on save

Screen 9: Welcome Complete

• Copy: "Welcome to Kalei. Your kaleidoscope is ready."
• Mini kaleidoscope pattern generated from their first Turn (deterministic, seeded from input)
• CTA: "Start exploring" → Tab bar appears, Turn tab active

---

Journey Stage 2: Daily Core Loop

2A: The Turn (Tab 1 — Amethyst ◇)

Entry: User opens app → Turn tab is default home

Empty State:

• Breathing logo at center, subtle floating shards in background
• Rotating prompts: "What thought keeps circling?", "What would you like to see differently?", "What feels heavy right now?"
• Single large text input area

Active Flow:

1. User types or speaks a negative thought
2. Tap "Turn it" button (Amethyst shimmer)
3. Turn animation plays (1.5s kaleidoscope rotation)
4. 3 reframed perspectives appear as cards:
   • Each card has a coaching style label, the reframe text, and a fragment icon
   • Cards use jewel tone gradients matching their style
5. Below perspectives: "If-Then Micro-Action" card
   • Format: "If [situation], then I will [specific action]"
   • Emerald accent, action-oriented
6. User actions:
   • Save any perspective → goes to Gallery as a Keepsake
   • Save micro-action → goes to Lens as a suggested action
   • Share → generates Pattern Card (kaleidoscope pattern + reframe text)
   • Dismiss → confirmation, thought is discarded

Turn History:

• Scrollable list below input showing today's Turns
• Each entry: timestamp, first line of thought, fragment count badge, pattern thumbnail

Rate Limiting (Free tier):

• 3 Turns per day
• After limit: "You've used your 3 Turns today. Upgrade to Kalei Prism for unlimited Turns."
• Gentle, never punishing

2B: The Mirror (Tab 2 — Amber ✦)

Entry: Mirror tab → New session or continue existing

Empty State:

• Soft amber glow background
• Copy: "What's on your mind? Write freely — no judgment, no rules."
• Suggested prompts rotate: "How are you feeling right now?", "What happened today?", "What's been on repeat in your head?"

Active Session Flow:

1. User writes freely in chat-like interface (user messages appear as dark bubbles)
2. After each message, AI processes silently (AI thinking animation: 3 oscillating fragments)
3. AI responds with warm, reflective prompts (light bubbles with subtle amber border)
4. Simultaneously, AI detects cognitive distortions in user's text
5. Detected fragments appear as inline highlights:
   • Amber glow underline beneath the distorted phrase
   • Small ◇ icon at start of highlight
   • Highlight appears post-message (never while typing)
6. User taps a highlight → Half-sheet modal:
   • Distortion type name + icon (from icons-distortions.svg)
   • Brief explanation: "Catastrophizing: Assuming the worst possible outcome"
   • 1-2 quick reframes
   • "Take to Turn" button → opens Turn with this thought pre-filled
   • Dismiss to continue writing

Session Close:

• User taps "End Session" or navigates away
• AI generates Reflection:
  • Themes detected
  • Fragment count and types
  • One-line insight
  • Unique kaleidoscope pattern (seeded from session content)
• Reflection saved to Gallery

Nudge System:

• If user ignores 5+ highlighted fragments, ONE gentle offer:
  • "I noticed a few patterns in what you wrote. Want to look at them together?"
  • Max once per session
  • Dismissible

Rate Limiting (Free): 2 sessions per week, 3 distortion types detected (Catastrophizing, Black-and-White, Should Statements). Prism: unlimited sessions, all 10 types.

2C: The Lens (Tab 3 — Emerald ◎)

Entry: Lens tab → Goal dashboard

Dashboard View:

• Active goals displayed as cards with progress rings
• Each goal card shows: title, progress percentage, next action, streak indicator
• "Add Goal" floating action button (Emerald gradient)

Goal Creation Flow (6 Steps):

Step 1: Decide — Set a SMART Goal

• AI-guided conversation to refine a vague desire into a specific goal
• Template: "I want to [specific outcome] by [date] measured by [metric]"
• AI suggests refinements if goal is vague

Step 2: See It — The View (Vision Board)

• AI generates a visualization description based on goal
• User can add personal images or AI-generated imagery
• "The View" appears as a full-screen card they can revisit

Step 3: Believe — Capability Building

• Evidence Wall integration: surfaces past achievements relevant to this goal
• AI generates affirmations based on goal + user's history
• Daily affirmation card appears at Lens tab top

Step 4: Notice — Attention Training

• AI prompts awareness exercises: "Today, notice one moment where you [goal-related behavior]"
• Prompts delivered via notification at user-chosen time
• User logs noticed moments → feeds Evidence Wall

Step 5: Act — If-Then Micro-Actions

• AI generates situation-specific implementation intentions
• Format: "If [context], then [specific action]"
• User can mark actions complete → feeds Evidence Wall
• Action completion streak tracking

Step 6: Compound — Habit Tracking

• Visual habit tracker (fragment-shaped step indicators)
• Streak counter with flame icon
• Weekly review of consistency

The Rehearsal (Lens Sub-Feature):

• Accessed from goal detail screen → "Rehearse" button
• Timer ring appears (default: 10 minutes)
• AI generates personalized visualization script:
  • First-person perspective
  • Multi-sensory (see, hear, feel, smell)
  • Process-oriented (not just outcome)
  • Includes obstacle rehearsal ("When X happens, I will Y")
• Script plays as text cards with breathing animation pacing
• Progress ring counts down
• Completion → Success burst → logged to Evidence Wall
• Free: 1 Rehearsal per week. Prism: unlimited.

2D: Gallery (Tab 4 — Sapphire ▦)

Entry: Gallery tab → Collection view

Views:

• All Patterns (default): Reverse-chronological grid of kaleidoscope pattern thumbnails
• Keepsakes: Saved reframes, reflections, and insights
• By Feature: Filter by Turn / Mirror / Lens source
• By Distortion: Filter by cognitive distortion type

Pattern Card Detail:

• Full kaleidoscope pattern (hero variant, animated)
• Source content (the reframe or reflection that generated it)
• Date, feature source, distortion types tagged
• Share button → exports as Pattern Card image
• Delete with confirmation

Search:

• Text search across all saved content
• Filter chips: date range, feature, distortion type, favorites

2E: You (Tab 5 — Soft Light ●)

Entry: You tab → Profile dashboard

Sections:

• Profile: Name, avatar, member since
• Stats Overview: Total Turns, Mirror sessions, Goals active, Streak count
• Evidence Wall (prominent card → opens full view)
• Settings: Coaching style, notification times, theme (dark only for now), data export
• Subscription: Current plan, upgrade CTA (if free)
• Support: FAQ, contact, crisis resources

The Evidence Wall (You Sub-Feature):

• Accessed from You tab → "Your Evidence Wall" card
• Opens full-screen mosaic view

Evidence Wall States:

Empty State (0-2 items):

• Ghost tile outlines (dashed borders) showing where tiles will appear
• Central fragment icon with breathing animation
• Copy: "Start collecting evidence. Each Turn adds a tile to your wall."

Early State (3-7 items):

• Small cluster of tiles, connections forming
• Tiles are mixed shapes (diamond, hex, rectangle, pentagon, triangle)
• Each tile represents one proof point:
  • Completed action (Emerald border)
  • Saved keepsake (Sapphire border)
  • Self-correction in Mirror (Amber border)
  • Streak milestone (Amethyst border)
  • Goal completion (Emerald border, larger tile)
  • Reframe echo (Indigo border) — when user's later writing echoes a saved reframe

Mid State (8-20 items):

• Mosaic takes shape, dashed connection lines between related tiles
• Tiles glow softly when tapped → detail half-sheet

Full State (20+ items):

• Dense mosaic with visible connection web
• Zoom/pan enabled
• Most impactful tiles glow brighter

Contextual Surfacing:

• During low self-efficacy moments (detected in Mirror or Turn), the Evidence Wall surfaces 1-2 relevant tiles
• Example: User writes "I can never stick to anything" → Evidence Wall suggests: "You completed 12 actions in the last month and maintained a 7-day streak"
• Presented as a gentle card, not a correction

---

Journey Stage 3: The Ritual (Connector Feature)

The Ritual chains Mirror → Turn → Lens into a single context-anchored daily flow.

Access: Dedicated "Start Ritual" button at top of Turn tab, or via notification

Template Selection:

Morning Ritual (15-20 min):

1. Mirror check-in: "How are you waking up today?" (3 min writing)
2. Turn: AI identifies strongest fragment from Mirror → offers reframe (2 min)
3. Lens: Today's priority action from active goal (1 min review)
4. Affirmation: Daily affirmation card
5. Set intention: One sentence for the day

Evening Ritual (10-15 min):

1. Mirror reflection: "What stood out about today?" (3 min writing)
2. Turn: Process any unresolved thought from the day (2 min)
3. Lens review: Mark completed actions, log noticed moments
4. Gratitude: One thing from today (saved to Gallery)

Quick Ritual (5 min):

1. One-line check-in
2. Fastest Turn (single perspective)
3. One action reminder

Ritual Flow UI:

• Step indicators using fragment-shaped progress bar (from progress-indicators.svg)
• Each step has a timer (visible but not pressuring)
• Smooth transitions between steps (fragment scatter/converge animation)
• Completion → Success burst → streak updated

Ritual Tracking:

• Streak calendar (7-day week view, Amber jewel tone)
• Context consistency tracking (Wood et al.): same time, same place → stronger habit
• Ritual completion logged to Evidence Wall

Rate Limiting (Free): Quick Ritual only. Prism: all 3 templates.

---

Journey Stage 3B: The Guide (Active Coaching Layer)

The Guide is not a tab or a destination — it's an intelligence layer that surfaces across all features through five interaction patterns. These screens show how each pattern manifests in the UI.

Guide Pattern 1: Goal Check-In (Lens)

Access: "Check in" button on goal detail screen, or via notification at user's chosen check-in time

Screen 65: Goal Check-In Conversation

A chat-like interface within the goal detail screen. The Guide has full context from the user's Lens activity, Mirror sessions, and Turn history.

Flow:

1. Guide opens with a recognition of recent progress (evidence-first)
2. Guide asks about specific milestones or actions since last check-in
3. User responds conversationally
4. Guide reviews relevant if-then plans — did the situations arise? Did the plans work?
5. If plans need adjustment, Guide proposes modifications collaboratively
6. Guide closes with a concrete Evidence Wall proof point

UI Elements:

• Chat interface within goal detail (not a separate screen — slides up from goal card)
• Guide messages use prismatic gradient border (distinguishing from Mirror's amber)
• User messages in dark bubbles (consistent with Mirror style)
• At bottom: typing area with send button
• Check-in history accessible via "Past check-ins" link

Screen 66: Check-In Summary

After the conversation ends, a summary card appears:

• What was reviewed
• Plan adjustments made (if any)
• Evidence highlighted
• Next check-in date
• "Added to your coaching history" confirmation

Rate Limiting (Free): 1 check-in per month per goal. Prism: weekly per goal + on-demand.

---

Guide Pattern 2: Cross-Feature Bridge Cards

Access: Appear automatically at the top of Turn, Mirror, or Lens tabs when the Guide detects a cross-feature pattern

Screen 67: Discovery Bridge

Appears when 3+ Mirror sessions or Turns share a theme that doesn't map to any existing Lens goal.

Layout:

• Half-height card at top of screen (below nav header, above feature content)
• Prismatic gradient border (thin, cycling amethyst → sapphire → emerald → amber)
• Header: "◇ Something keeps coming up" (or "A pattern is forming")
• Body: 1-2 sentences referencing the theme, with quoted user text in italics
• CTAs: Primary action (e.g., "Open Lens" / "Start a goal") + Dismiss ("Just noticing")
• Dismissible with swipe or tap

Screen 68: Reinforcement Bridge

Appears when Mirror/Turn content directly relates to an existing Lens goal.

Layout: Same card format as discovery bridge.

• Header: "◇ This connects to something you're building"
• Body: References the specific goal and how the current processing connects to it
• CTAs: "Start Rehearsal" / "Check in on goal" + Dismiss

Screen 69: Integration Bridge

Appears when current Mirror/Turn writing contradicts a previously saved keepsake.

Layout: Same card format, but includes a quoted keepsake.

• Header: "◇ You've seen this differently before"
• Body: Shows the saved keepsake text, then the current contradicting sentiment
• CTAs: "See your Evidence Wall" / "Full Turn" + "Continue writing"

Rules: Maximum one bridge per day. Never appears mid-Mirror session. Always dismissible.

---

Guide Pattern 3: Attention Prompts (Lens)

Access: Daily notification → opens in Lens tab. Also accessible from Lens dashboard as a card.

Screen 70: Daily Attention Prompt

Layout:

• Card in Lens tab (below goals, above rehearsals)
• Emerald accent border (Lens color family)
• Header: "Today's Focus: [Prompt Type]" (Notice / Reflect / Act / Envision)
• Body: The specific prompt, 1-2 sentences, tied to the active goal
• Goal reference: "For your goal: [goal title]"
• CTA: "Got it" (acknowledges) + "Log a moment" (appears later in the day)
• Prompt type rotates based on which step of the manifestation chain the user is in

Screen 71: Moment Log

When user taps "Log a moment" (later in the day or from notification):

Layout:

• Simple text input: "What did you notice?"
• Below: context reminder of today's prompt
• Submit → confirmation: "That's evidence. Added to your Evidence Wall."
• The logged moment appears as a new Evidence Wall tile

Rate Limiting (Free): 3 attention prompts per week. Prism: daily.

---

Guide Pattern 4: Evidence Intervention

Access: Surfaces automatically during Mirror sessions or after Turns when low self-efficacy is detected

Screen 72: Evidence Intervention Card (Mirror)

Appears after a Mirror session ends (never mid-session) when the session contained significant self-efficacy dip language.

Layout:

• Card at bottom of Mirror reflection screen
• Prismatic border
• Header: "◇ Here's what I've seen"
• Body: 2-3 specific, numbered proof points from Evidence Wall that directly counter the expressed doubt
• Each proof point includes a specific number, date, or action
• CTA: "See your full Evidence Wall" + Dismiss
• Tone: Presenting evidence, not cheerleading. "You said X. Your data shows Y."

Screen 73: Evidence Intervention Card (Turn)

Appears below Turn results when the original thought contained capability doubt on a topic where the user has evidence.

Layout:

• Same card format as Mirror intervention
• Positioned below the 3 reframe cards, above the action buttons
• Contextually references the Turn's topic

Rules: Maximum one intervention per session. Only surfaces when meaningful evidence exists. Never fabricates or exaggerates.

Rate Limiting (Free): Not available. Prism: full evidence interventions.

---

Guide Pattern 5: Weekly Pulse

Access: Weekly notification on user's chosen day (default: Sunday evening) → opens dedicated Pulse flow

Screen 74: Pulse — Self-Report

Step 1 of 3 in the Weekly Pulse flow.

Layout:

• Full-screen flow (no tab bar — immersive like Ritual)
• Header: "Your Weekly Pulse"
• Subheader: "How did this week feel?"
• 5-point fragment scale (SVG diamonds at increasing glow/facet levels):
  • ◇ dim, cracked — "Rough"
  • ◇ muted — "Harder than usual"
  • ◇ neutral — "Steady"
  • ◇ glowing — "Good momentum"
  • ◇ brilliant, faceted — "Breakthrough week"
• Below scale: optional one-sentence write-in
• Progress indicator: Step 1 of 3

Screen 75: Pulse — AI Read

Step 2 of 3.

Layout:

• Header: "Here's what I noticed this week"
• 3-5 bullet observations from the AI, each with a jewel-tone accent dot:
  • Turn count and theme
  • Mirror session emotional trajectory
  • Lens goal progress
  • Distortion pattern changes
  • Streak/consistency data
• If self-report diverges from data: a highlighted callout — "You said this was a rough week, but your data shows progress on two fronts. Sometimes the feeling lags behind the evidence."
• Progress indicator: Step 2 of 3

Screen 76: Pulse — Next Week Focus

Step 3 of 3.

Layout:

• Header: "For next week"
• 2-3 suggested focus areas as cards:
  • Each card: one-sentence suggestion + the feature it relates to (Lens, Mirror, Rehearsal, etc.)
  • Examples: "Do a Rehearsal for your 5K — you haven't done one in 10 days" / "Your Mirror streak is at 14 days — keep it going"
• CTAs: "Sounds good" (accepts) / "Adjust" (opens edit)
• Completion: "Pulse complete. See you next week."
• Pulse data saved → feeds Spectrum

Rate Limiting (Free): Self-report step only (no AI read, no next-week focus). Prism: full 3-step Pulse.

---

Guide — Enhanced Turn Results (Updated Screen 13)

The existing Turn Results screen (13) is enhanced with two new elements:

Addition 1: If-Then Micro-Action Card

Positioned between the reframe cards and the action buttons:

• Emerald accent border
• Format: "If [situation from the thought], then I will [specific action]"
• CTA: "Save to Lens" → creates an action item on the most relevant active goal
• If no active goal exists: "Start a Lens goal around this"

Addition 2: Goal Connection (when relevant)

If the Turn's topic maps to an active Lens goal:

• Small card below the micro-action: "This connects to your goal: [goal title]"
• CTA: "Check in on this goal" / Dismiss

---

Guide — Enhanced Mirror Reflection (Updated Screen 19)

The existing Mirror Session Reflection screen (19) is enhanced:

Addition: "The Guide noticed..." section

Below the existing reflection content (themes, fragment count, patterns, insight):

• Prismatic-bordered card
• Header: "The Guide noticed..."
• 1-2 cross-feature observations:
  • Theme connections to Lens goals
  • Pattern changes compared to recent sessions
  • Integration bridge opportunities (if a saved keepsake was contradicted)
• CTAs appropriate to the observation (e.g., "Open Lens" / "See your Evidence Wall" / Dismiss)

---

Journey Stage 4: Spectrum (Intelligence Layer)

Unlock: After 2 weeks of active use (minimum 5 Turns, 2 Mirror sessions)

Teaser Period:

• Notification: "Something is forming... Your Spectrum is almost ready."
• Small locked card on You tab with shimmer animation

Launch Reveal:

• Full-screen animation: fragments converge into prismatic kaleidoscope
• User's first Spectrum dashboard appears

Dashboard Components:

The River (Emotional Flow):

• Flowing prismatic gradient band showing emotional valence over time
• Data points as fragment icons at key moments
• X-axis: days/weeks, Y-axis: emotional valence
• Hover/tap any point → detail card with source Turn/Mirror session

Your Glass (Distortion Distribution):

• Radar/spider chart showing which of the 10 distortion types appear most
• Amber jewel tone data shape on hex grid
• Vertices as fragment icons
• Evolves weekly as patterns shift

Turn Impact (Before/After):

• Bar chart pairs showing emotional metrics before and after Turns
• Metrics: Distress level, Clarity, Hope
• Ruby bars (before) vs Emerald bars (after)
• Rolling 30-day average

Rhythm Detection (Your Cycles):

• Time-of-day engagement pattern
• Bubble sizes represent intensity
• Peak labels with fragment accents
• Helps user identify best times for practice

Growth Trajectory (The Long View):

• Line chart with fragment data points
• Y-axis: Resilience Score (composite of fragment density, self-correction rate, reframe adoption, distortion diversity, Turn-to-insight ratio)
• Milestone markers (10th Turn, 30-day streak, etc.)
• Monthly trend with prismatic gradient fill under curve

Cadence:

• Weekly summary: Sunday evening notification with 1 key insight
• Monthly deep dive: First of month with month-over-month comparison
• In-context nudges: Insights surface within Mirror/Turn/Lens at natural moments

Rate Limiting (Free): Simplified weekly summary (1 insight, no visuals, basic fragment counts). Prism: full dashboard, all 5 components, weekly/monthly deep dives, growth trajectory, export.

---

Journey Stage 5: Engagement Deepening & Retention

Streak System

• Daily streak counter (consecutive days with at least 1 Turn or Ritual)
• Visual: flame icon with Amber gradient, pulse animation
• Milestones: 3, 7, 14, 30, 60, 90, 180, 365 days
• Each milestone → special pattern generated, saved to Gallery
• Streak freeze: 1 free per week (Prism: 3 per week)

Push Notifications

• Daily check-in at user's chosen time
• Streak maintenance reminders (if about to break)
• Milestone celebrations
• Weekly Spectrum insights (Prism)
• Ritual reminders at consistent time/place
• Never more than 2 per day

Empty States

• Every screen has a warm, encouraging empty state
• Uses breathing logo animation or floating shard clusters
• Copy examples:
  • Turn: "What would you like to see differently today?"
  • Mirror: "Ready to write? There's no wrong way to start."
  • Lens: "What are you working toward? Let's build a path."
  • Gallery: "Your first pattern is waiting to be created."
  • Evidence Wall: "Every small step is evidence. Start collecting."

Upgrade Moments (Free → Prism)

• After hitting 3 Turn limit: "You're on a roll. Unlock unlimited Turns."
• After 2nd Mirror session: "Want to explore all 10 distortion types?"
• After first Rehearsal: "That felt good, right? Get unlimited Rehearsals."
• After Evidence Wall shows 10+ tiles: "Your evidence is growing. See the full picture with Spectrum."
• Never blocks current action — always shows after completion

---

Journey Stage 6: System States

Loading States

• Initial load: Breathing logo animation
• Feature transitions: Fragment scatter/converge
• AI processing: 3-fragment oscillation (AI thinking bubble)
• Data loading: Skeleton shimmer (text lines + card shapes)
• Long operations: Iris spinner with progress text

Error States

• Network error: "Lost connection. Your data is safe — we'll sync when you're back."
• AI error: "Our thinking engine needs a moment. Try again in a few seconds."
• Rate limit: Feature-specific messaging (see each feature above)
• Generic: Ruby-accent toast with retry option

Success States

• Turn saved: Emerald toast "Turn saved" with fragment icon
• Goal completed: Success burst animation (expanding rings + particle fragments)
• Streak milestone: Special celebration with pattern generation
• Ritual complete: Prismatic ring completion animation

Offline Mode

• Turn input cached locally, syncs when online
• Mirror sessions continue with local fragment detection (basic)
• Gallery browsable offline
• Clear indicator: "Offline — your work will sync automatically"

---

Monetization Tiers

Kalei (Free)

Feature	Limit
Turn	3 per day
Mirror	2 sessions per week, 3 distortion types
Lens	1 active goal, basic actions
Rehearsal	1 per week
Ritual	Quick template only
Evidence Wall	30-day window
Guide	Discovery bridges only, 1 check-in/month/goal, 3 attention prompts/week, self-report Pulse only
Gallery	Full access
Spectrum	Simplified weekly summary (text only)

Kalei Prism ($7.99/month)

Feature	Access
Turn	Unlimited + if-then micro-action cards
Mirror	Unlimited sessions, all 10 distortion types, unlimited inline reframes + evidence interventions
Lens	Unlimited goals, AI-refined actions + weekly check-ins + daily attention prompts
Rehearsal	Unlimited
Ritual	All 3 templates
Evidence Wall	Full history, no time window + contextual AI surfacing
Guide	All 5 patterns: full check-ins, all bridge types, daily prompts, evidence interventions, full Pulse
Gallery	Full access + export
Spectrum	Full dashboard, all 5 components, weekly/monthly insights, growth trajectory

---

Appendix: Screen Inventory

#	Screen	Tab	Feature
1	Splash	—	System
2	Welcome	—	Onboarding
3	Fragment Intro	—	Onboarding
4	Turn Demo	—	Onboarding
5	Style Selection	—	Onboarding
6	Notification Permission	—	Onboarding
7	Account Creation	—	Onboarding
8	First Turn	—	Onboarding
9	Welcome Complete	—	Onboarding
10	Turn Home (empty)	Turn	Turn
11	Turn Input Active	Turn	Turn
12	Turn Animation	Turn	Turn
13	Turn Results	Turn	Turn
14	Turn History	Turn	Turn
15	Mirror Home (empty)	Mirror	Mirror
16	Mirror Session Active	Mirror	Mirror
17	Mirror Fragment Highlight	Mirror	Mirror
18	Mirror Fragment Detail (half-sheet)	Mirror	Mirror
19	Mirror Session Reflection	Mirror	Mirror
20	Lens Dashboard	Lens	Lens
21	Lens Goal Creation Step 1	Lens	Lens
22	Lens Goal Creation Step 2	Lens	Lens
23	Lens Goal Creation Step 3	Lens	Lens
24	Lens Goal Creation Step 4	Lens	Lens
25	Lens Goal Creation Step 5	Lens	Lens
26	Lens Goal Creation Step 6	Lens	Lens
27	Lens Goal Detail	Lens	Lens
28	Lens Daily Affirmation	Lens	Lens
29	Rehearsal Session	Lens	Rehearsal
30	Rehearsal Complete	Lens	Rehearsal
31	Gallery All Patterns	Gallery	Gallery
32	Gallery Keepsakes	Gallery	Gallery
33	Gallery Pattern Detail	Gallery	Gallery
34	Gallery Search/Filter	Gallery	Gallery
35	You Profile	You	You
36	You Stats	You	You
37	You Settings	You	Settings
38	You Subscription	You	Billing
39	Evidence Wall (empty)	You	Evidence Wall
40	Evidence Wall (early)	You	Evidence Wall
41	Evidence Wall (mid)	You	Evidence Wall
42	Evidence Wall (full)	You	Evidence Wall
43	Evidence Wall Tile Detail	You	Evidence Wall
44	Ritual Template Selection	Turn	Ritual
45	Ritual Morning Flow	Turn	Ritual
46	Ritual Evening Flow	Turn	Ritual
47	Ritual Quick Flow	Turn	Ritual
48	Ritual Complete	Turn	Ritual
49	Ritual Streak View	Turn	Ritual
50	Spectrum Dashboard	You	Spectrum
51	Spectrum The River	You	Spectrum
52	Spectrum Your Glass	You	Spectrum
53	Spectrum Turn Impact	You	Spectrum
54	Spectrum Rhythm	You	Spectrum
55	Spectrum Growth	You	Spectrum
56	Spectrum Weekly Summary	You	Spectrum
57	Spectrum Monthly Deep Dive	You	Spectrum
58	Upgrade Modal	—	Billing
59	Rate Limit Notice	—	System
60	Crisis Response	—	Safety
61	Pattern Card Share	—	Social
62	Notification Settings	You	Settings
63	Data Export	You	Settings
64	Account Deletion Confirm	You	Settings
65	Goal Check-In Conversation	Lens	Guide
66	Check-In Summary	Lens	Guide
67	Discovery Bridge Card	Turn/Mirror/Lens	Guide
68	Reinforcement Bridge Card	Turn/Mirror/Lens	Guide
69	Integration Bridge Card	Mirror	Guide
70	Daily Attention Prompt	Lens	Guide
71	Moment Log	Lens	Guide
72	Evidence Intervention (Mirror)	Mirror	Guide
73	Evidence Intervention (Turn)	Turn	Guide
74	Pulse — Self-Report	—	Guide
75	Pulse — AI Read	—	Guide
76	Pulse — Next Week Focus	—	Guide
13*	Turn Results (Enhanced)	Turn	Guide + Turn
19*	Mirror Reflection (Enhanced)	Mirror	Guide + Mirror