# Kalei — Product & Experience Design ### *A kaleidoscope for your mind. Same pieces. New angle.* --- ## The Metaphor A kaleidoscope takes broken, random fragments of glass and reveals them as beautiful, symmetrical patterns. It never changes the pieces — it changes the **angle**. Turn it once, and chaos becomes art. Turn it again, and the same fragments form something entirely new. Kalei does the same thing with your thoughts. Your situation hasn't changed. Your circumstances are the same fragments they were a moment ago. But Kalei shifts the angle — and suddenly you see the pattern, the meaning, the opportunity that was always there. This isn't toxic positivity. A kaleidoscope doesn't pretend the glass isn't broken. It proves that broken things can still be beautiful. --- ## The Four Pillars Kalei is built on four optical instruments. Each one does something different with light. Together, they form a complete system for seeing your life from new angles. | Pillar | Feature | Optical Element | User Need | Phase | |--------|---------|----------------|-----------|-------| | **Awareness** | The Mirror | Mirror | "I need to process" | Phase 1 | | **Perspective** | The Kaleidoscope | Kaleidoscope | "I need to see this differently" | Phase 1 | | **Direction** | The Lens | Lens | "I need to move forward" | Phase 1 | | **Intelligence** | The Spectrum | Prism | "I need to understand myself" | Phase 2 | These four pillars form a natural progression: ``` THE MIRROR THE KALEIDOSCOPE THE LENS THE SPECTRUM (Awareness) → (Perspective) → (Direction) → (Intelligence) "What am I "How else can I "What am I "What patterns feeling?" see this?" building toward?" define me?" Freeform Structured Goal-focused AI-powered writing reframing manifestation self-knowledge Fragments Fragments → Patterns Patterns → Focus All data → Insight detected revealed applied understood ``` Not every session follows this sequence. Some days you just need a quick Turn. Some days you just need to write in the Mirror. Some days you go straight to the Lens. But when a user flows through all four, that's the **Kalei experience** at its deepest — and the Spectrum ties it all together with longitudinal intelligence. --- ## Brand Language ### Vocabulary Every app builds an unconscious vocabulary through the words it uses in buttons, headers, notifications, and empty states. Kalei's vocabulary reinforces the metaphor without being heavy-handed. **Primary Terms (Use Frequently)** | Instead of... | Kalei says... | Why | |----------------------|----------------------|--------------------------------------------------------| | Reframe | **Turn** | You "turn" a kaleidoscope to see a new pattern | | Negative thought | **Fragment** | Broken glass — raw material, not a flaw | | Reframed perspective | **Pattern** | The beautiful arrangement revealed by a new angle | | Journal entry | **Reflection** | Light + mirrors = what a kaleidoscope runs on | | Daily session | **Turn of the day** | Each day you take a fresh turn | | Progress/history | **Gallery** | A collection of the patterns you've created | | Insight | **Facet** | One face of a multifaceted view | | Saved reframe | **Keepsake** | A pattern worth holding onto | **Secondary Terms (Use Sparingly for Flavor)** - **Shift** — a small adjustment in perspective - **Prism** — the tool that splits one beam into many colors - **Mosaic** — the bigger picture built from many small pieces - **Spectrum** — the full range of ways to see something - **Illuminate** — to light up what was hidden - **Refract** — to bend light in a new direction **Words to Avoid** - "Fix" — implies the user is broken - "Heal" — too clinical, positions app as therapy - "Transform" — too dramatic, overpromises - "Positive vibes" — trivializes the process - "Journey" — overused in wellness apps - "Self-care" — generic, says nothing ### Voice & Tone **Kalei speaks like:** A wise friend who sees beauty in hard things — not a therapist, not a guru, not a cheerleader. Calm. Grounded. A little poetic. Never preachy. **Tone:** Warm but not soft. Confident but not aggressive. Poetic but not flowery. | Situation | ❌ Wrong tone | ✅ Kalei tone | |-----------|-------------|-------------| | User inputs a negative thought | "Let's turn that frown upside down!" | "Let's see what this looks like from another angle." | | User completes a reframe | "Amazing job! You're so strong!" | "There it is. A pattern worth keeping." | | User hasn't opened app in a week | "We miss you! Come back!" | "Still here. Ready when you are." | | Explaining the app | "AI-powered cognitive reframing tool" | "A kaleidoscope for your mind." | --- --- # Feature Design --- ## The Mirror — Awareness > *The mirror doesn't tell you what to see. It shows you what's already there.* ### Concept The Kaleidoscope (Turn) is structured: one fragment in, patterns out. It works when you **know** what's bothering you. But most of the time, people don't. They're carrying a vague heaviness — a bad day, an argument replaying in their head, a worry they can't articulate. They don't need a tool yet. They need a space to **think out loud** first. **The Mirror** is that space. It's a freeform notebook with a chat-like interface where you write whatever's on your mind — stream of consciousness, venting, processing. As you write, Kalei's AI reads along quietly and does two things: 1. **Highlights fragments** — gently marks phrases that carry negative cognitive patterns (catastrophizing, black-and-white thinking, personalization, fortune-telling, etc.) 2. **Offers to Turn them** — tapping a highlighted fragment opens a mini-reframe inline, without leaving the flow of writing You're not journaling into a void. You're writing into a mirror that reflects back what you can't see yourself. ### Why "The Mirror" A kaleidoscope is built from mirrors. The mirrors are what create the symmetry — what take a random fragment and reveal the pattern. Without the mirrors, it's just broken glass. The Mirror feature is the reflective surface of Kalei. - You write freely → you're pouring fragments onto the table - Kalei highlights patterns → the mirror reflects back what you couldn't see - You tap to reframe → you choose which fragments to Turn - The session becomes a Reflection → saved to your Gallery with its own pattern ### The Writing Experience **Visual:** Chat-style interface. The user's messages appear as bubbles or blocks on one side. Clean, minimal, dark background. No AI responses appear unprompted — the AI is **listening**, not talking. **Prompt on empty state:** > "Start writing. Say whatever's on your mind. I'll listen." > *Kalei will gently highlight patterns it notices. You decide what to do with them.* **User writes freely.** They can send multiple messages in sequence, like texting a friend. No character limits. No structure required. ### Fragment Detection As the user writes (after each message is sent), Kalei's AI analyzes the text for **cognitive distortion patterns** — the same patterns CBT identifies as drivers of negative thinking: | Distortion | Example | What Kalei detects | |---|---|---| | Catastrophizing | "This is going to ruin everything" | Absolutist prediction language | | Black-and-white thinking | "I always fail at this" | Always/never, all-or-nothing | | Mind reading | "They probably think I'm an idiot" | Assuming others' thoughts | | Fortune telling | "This will never get better" | Predicting negative outcomes | | Personalization | "It's all my fault" | Taking undue responsibility | | Discounting positives | "That win was just luck" | Minimizing good things | | Emotional reasoning | "I feel like a failure so I must be one" | Feelings presented as facts | | Should statements | "I should be further along by now" | Rigid self-imposed rules | | Labeling | "I'm such a loser" | Identity-level negative labels | | Overgeneralization | "Nothing ever works out for me" | One event → universal pattern | **How highlighting appears:** - Detected phrases get a **subtle underline or soft glow** in warm amber/gold — the color of light catching a fragment - The highlight is gentle, not aggressive. It should feel like sunlight falling on a piece of glass — drawing attention naturally, not correcting homework - A small **◇ icon** (fragment symbol) appears at the end of the highlighted phrase - Highlights appear **after the user finishes a message** — never while typing **Critical UX principle:** The highlighting must feel like **noticing**, not **judging**. The AI is a mirror, not a critic. The user should feel seen, not corrected. ### Tapping a Fragment — Inline Reframing When the user taps a highlighted fragment: 1. A **mini-card slides up** from below (half-sheet modal — user can still see their writing above) 2. The card shows: - The original fragment, quoted - The cognitive pattern name in plain language - **1–2 reframed alternatives** — shorter and lighter than a full Turn - A "Full Turn" button to take the fragment into the Kaleidoscope for deeper exploration - A "Dismiss" option **Example interaction:** > **User writes:** "Had a terrible meeting today. My manager barely acknowledged my presentation. She probably thinks I'm not cut out for this role. I should just start looking for another job." > **Kalei highlights:** "She probably thinks I'm not cut out for this role" > **User taps. Card appears:** > **◇ Fragment detected** > *"She probably thinks I'm not cut out for this role"* > > This looks like **mind reading** — assuming someone else's thoughts without evidence. > > **A different angle:** > There are many reasons a manager might seem distracted that have nothing to do with your performance. What you observed was her behavior. What she thinks is something you don't have access to yet — but you could ask. > > **[Full Turn ◇]** · **[Dismiss]** ### The AI's Role — Passive, Not Conversational **This is critical.** The Mirror is NOT a chatbot. The AI does not respond to every message, ask follow-up questions, inject unsolicited advice, or break the user's flow with interjections. The AI **only** does three things: 1. Highlights fragments (passively, after each message) 2. Provides reframes when the user taps a highlight (on demand) 3. Generates a session summary when the user ends the session **Why not a chatbot?** Because the whole point is that the user is thinking out loud. Inserting AI responses turns it into a conversation with a bot, which changes the psychology entirely. The user stops introspecting and starts performing. The Mirror should feel like writing in a journal that occasionally catches the light — not like talking to a therapist. **Exception — The Nudge:** If the user has written 5+ messages with zero taps on any highlights and significant negative patterns are accumulating, Kalei can offer ONE gentle nudge: > "I noticed a few fragments in what you wrote. Want to look at them together?" > **[Show me]** · **[Not now]** Once per session maximum. ### Session Wrap-Up — The Reflection When the user signals they're done writing (closes the Mirror, presses "Done," or after inactivity), Kalei generates a **Reflection**: 1. **The Mosaic** — a high-level summary of themes (not specifics) > "Today's Mirror covered: work frustration, self-doubt about career, and a conflict with your manager." 2. **Fragments Found** — count of cognitive patterns detected > "4 fragments noticed. You explored 2 of them." 3. **Patterns Revealed** — the reframes the user engaged with > "You looked at mind reading and catastrophizing from new angles." 4. **A Generated Pattern** — a unique kaleidoscope visual for this session, saved to the Gallery. Mirror sessions get their own visual style — softer, more organic geometry to distinguish from structured Turns. 5. **An optional one-line insight** — the AI's single most important observation > "You were hardest on yourself about things you haven't confirmed are true." The Reflection is saved to the Gallery as a distinct type: a Mirror Reflection. --- ## The Kaleidoscope — Perspective > *The Kaleidoscope helps you see beauty in what's already there.* ### Concept The flagship feature. User inputs a negative thought (a fragment), and Kalei reveals multiple reframed perspectives (patterns). This is the core mechanic — structured, immediate, and satisfying. ### User Flow - **CTA button:** "Turn" (verb — active, simple, one word) - **Input prompt:** "Drop in a fragment" or "What's on your mind?" - **Loading state:** A kaleidoscope rotation animation (~1.5 seconds) - **Results header:** "Here's what the same pieces look like from a new angle" - **Individual reframes:** Displayed as "Pattern 1," "Pattern 2," "Pattern 3" — each a different arrangement of the same facts - **Save action:** "Keep this pattern" ### Turn Tab (Home Screen) - Hero area: "What's the fragment?" — text input - Below: "Turn of the day" — a featured prompt or previous pattern - Below: "Recent patterns" — quick access to last 3 Turns - Floating action: Quick Turn button (always accessible) ### Reframe Styles (Prism) Premium users can select a reframing perspective: - **Stoic** — what would Marcus Aurelius say - **Compassionate** — self-compassion and kindness angle - **Pragmatic** — practical next-step focus - **Growth** — how this builds future strength ### Prompt Engineering ``` System prompt context: "You are the engine behind Kalei, a kaleidoscope for the mind. The user gives you a fragment — a negative thought or situation. Your job is to reveal the patterns — multiple genuine, grounded perspectives on the same situation. You never change the facts. You change the angle. You are not a therapist. You are not toxic positivity. You are a kaleidoscope: you show what was already there, arranged in a way the user hadn't seen before." ``` --- ## The Lens — Direction > *The Lens helps you focus on what's ahead.* ### Concept If the Kaleidoscope shows you new patterns in what already exists, the Lens focuses your vision on what you're building toward. Goal-setting and manifestation, powered by AI. ### Vocabulary - **Section header:** "Your Lens" - **Goal creation:** "Set your focus" - **Daily affirmation:** "Today's focus" - **Vision board:** "The View" — what you see when you look through the lens - **Progress check-in:** "Sharpen your focus" - **Milestone reached:** "Crystal clear" ### Lens Tab - Current focus (active goal) displayed prominently - Today's affirmation - Vision board / The View - Progress tracker with "sharpening" visual metaphor ### Integration with Other Features The Lens connects insights from other features to forward momentum: - Patterns discovered in the Mirror inform what goals matter - Reframes from the Kaleidoscope become fuel for goal pursuit - The Spectrum (Phase 2) validates that Lens check-ins correlate with reduced negative patterns --- ## The Spectrum — Intelligence (Phase 2) > *White light looks simple. The Spectrum shows you everything it's made of.* ### Concept Every wellness app asks you to rate your mood on a scale. Tap a smiley face. Drag a slider. It's self-reported, inaccurate, and most people stop doing it after two weeks because it feels like homework. Kalei doesn't need to ask how you feel. **It already knows.** By Phase 2, users have weeks or months of Mirror sessions, Turns, and Lens activity. Every word they've written, every fragment detected, every pattern revealed, every reframe they saved or dismissed — it's all data. Rich, personal, longitudinal emotional data that the user generated naturally while using features they already love. The Spectrum turns that data into **self-knowledge**. ### Why "The Spectrum" Light enters a prism and exits as a spectrum — the full range of colors that were always present but invisible to the naked eye. The Spectrum takes the raw light of your daily Kalei usage and separates it into its component colors so you can see what's really going on inside. ### The Five Components #### 1. The Emotional Landscape — "The River" A visual representation of emotional state over time — not from self-reporting, but from **AI analysis of Mirror sessions, Turns, and Lens check-ins.** Every Mirror message and Turn input is analyzed for emotional signatures across six dimensions: - **Valence:** Positive ↔ Negative - **Arousal:** Calm ↔ Activated - **Certainty:** Confident ↔ Uncertain - **Agency:** In control ↔ Helpless - **Social orientation:** Connected ↔ Isolated - **Temporal focus:** Past-dwelling ↔ Present ↔ Future-focused These dimensions are plotted over time as a **flowing gradient visualization** — not a line chart, but a river of color that shifts and blends. Warm colors for activated states, cool for calm, dark for negative, bright for positive. **The user sees:** - The overall color/tone of their week at a glance - Shifts and transitions (Tuesday was dark and activated → Wednesday calmed after a Turn) - Long-term trends (past month trending brighter, or a slow slide they hadn't noticed) **What they don't see:** Numbers, scores, or ratings. The Spectrum is visual and intuitive, not clinical. #### 2. Fragment Patterns — "Your Glass" A breakdown of which cognitive distortion types appear most frequently in the user's writing. **Visualization:** A faceted gem or crystal with different faces representing different distortion types. The larger the face, the more frequently that pattern appears. The gem evolves over time as patterns shift. **Insights delivered in plain language:** > "This month, **should statements** made up 34% of your fragments — up from 22% last month. You're putting more pressure on yourself than usual." > "**Mind reading** dropped significantly since you started Turning those fragments. You assumed others' thoughts 8 times in January, only twice in February." Most people have 2–3 dominant cognitive distortions they don't know about. Seeing them named and tracked over time is genuinely transformative — the kind of insight you'd normally get after months of therapy. #### 3. Turn Impact — "Before & After" Tracks the measurable effect of reframing on subsequent emotional state. The AI compares the emotional tone of Mirror sessions **before and after** a Turn: - User writes in Mirror (frustrated, catastrophizing) - User takes a fragment to the Kaleidoscope - User writes in Mirror again later - The Spectrum measures the shift **What the user sees:** > "After Turning a fragment, your next Mirror session is 62% more likely to show increased agency and reduced catastrophizing." > "Turns on work-related fragments have the strongest positive effect for you. Relationship fragments take 2–3 Turns before the shift shows up." This is the **evidence engine** for Kalei's core thesis: changing the angle actually changes how you feel. Users see the proof in their own data. #### 4. Rhythm Detection — "Your Cycles" Identifies recurring emotional patterns tied to time. > "Your Mirror sessions on Mondays contain 3x more should statements than any other day." > "The last week of each month shows elevated anxiety patterns — possibly tied to deadlines or financial cycles." > "When you check in with your Lens goals in the morning, your afternoon Mirror sessions show 40% fewer negative fragments." The user starts to see their emotional life as a **landscape with terrain** rather than random weather. Some hills are always there. Some valleys are seasonal. #### 5. Growth Trajectory — "The Long View" The headline metric: how is this person's relationship with their own thinking changing over time? **Tracked indicators:** - Fragment density: distortions per 100 words in Mirror sessions (trending down = growth) - Self-correction rate: how often users identify their own fragments before Kalei highlights them - Reframe adoption: how often saved patterns echo in subsequent Mirror writing - Distortion diversity: whether the user addresses multiple types or gets stuck on one - Turn-to-insight ratio: how many Turns result in a saved keepsake **Visualization:** A single, evolving kaleidoscope pattern representing overall growth. The more you use Kalei, the more complex, colorful, and beautiful the pattern becomes. At month 1, simple and muted. At month 6, intricate and vivid. This becomes the **centerpiece of the Spectrum dashboard** — personal growth as a living kaleidoscope pattern. ### Dashboard Layout - **Top: The River** — emotional landscape gradient. Swipe horizontally through time. Tap any point for that day's Mirror session or Turn. - **Middle: Your Glass** — faceted gem showing fragment distribution. Toggle week/month/all-time. Tap any facet for distortion deep-dive. - **Bottom: Insights Feed** — scrollable AI-generated insights, refreshed weekly. Each insight is a card with a one-line observation, supporting data, and action suggestion. - **Floating: Your Pattern** — evolving kaleidoscope pattern, top corner. Tap to expand full-screen. Shareable as a "growth snapshot." ### Insight Delivery Timing The Spectrum doesn't bombard users with data. Insights surface at natural moments: **Weekly Reflection** (Sunday evening): "Your Spectrum updated. See what this week's light revealed. 🔮" Opens to a Weekly Spectrum Summary with dominant emotional color, top fragment type, most impactful Turn, one insight, and the week's addition to the evolving pattern. **Monthly Deep Dive** (first of each month): Month-over-month comparisons, rhythm detection insights, and growth trajectory updates. **In-Context Nudges** within other features: - Mirror: "You've used the phrase 'I should' 4 times this session. That's a pattern worth noticing." - After a Turn: "This is the 3rd time you've Turned a work-related fragment this week. The Spectrum can show you more about this pattern." - Lens: "Your Lens focus on [career growth] aligns with the fragments you've been processing. You're working on the right things." --- --- # Experience Design --- ## Visual Design Language ### The Kaleidoscope Aesthetic The visual identity evokes the feeling of looking through a kaleidoscope without being literal or childish. **Color Palette:** - **Primary:** Deep jewel tones — amethyst purple, sapphire blue, emerald green - **Secondary:** Warm golds and soft amber (the light passing through glass) - **Background:** Near-black or deep navy (the dark tube of a kaleidoscope — fragments shine against darkness) - **Accent:** Prismatic gradients for highlights and CTAs (light refracting) **Why dark backgrounds:** A kaleidoscope works by reflecting light against darkness. The dark UI makes colorful elements pop — and positions Kalei as premium, not bubbly. **Avoid:** Pastel wellness aesthetic. No sage green, no cream, no watercolor blobs. Kalei is jewel-toned, rich, and confident. **Typography:** - Clean, modern sans-serif for body text (clarity, legibility) - One geometric or slightly decorative font for headlines (faceted, angular — like cut glass) **Iconography:** - Geometric and faceted — hexagons, triangles, crystalline shapes - Avoid circles and soft curves (that's every other wellness app) - Subtle symmetry in icon design (mirrors the symmetry of kaleidoscope patterns) --- ## Navigation & Information Architecture ### Tab Bar (5 tabs) | Icon | Label | Function | |------|-------|----------| | ◇ (geometric shard) | **Turn** | The Kaleidoscope — quick structured reframe | | ✦ (hexagonal mirror) | **Mirror** | Freeform notebook with AI awareness | | ◎ (lens/circle) | **Lens** | Goals, focus, and manifestation | | ▦ (grid of patterns) | **Gallery** | History of all patterns and reflections | | ● (profile) | **You** | Settings, stats, subscription, profile | ### Gallery Tab - Grid view of kaleidoscope patterns, each linked to a saved reframe or Mirror Reflection - Filterable by date, mood tag, or theme - Tap to expand: see original fragment, patterns revealed, and notes - Option to reshare or re-Turn (reframe same thought for fresh perspectives) ### You Tab - Streak counter: "X-day turning streak" - Stats: Total turns, patterns saved, most common themes - Settings, subscription management - Spectrum access (Prism users, Phase 2) --- ## Signature Animations ### The Turn (Core Animation) The most important animation in the app. Triggered when a user submits a thought for reframing: 1. **Input phase:** Fragment icon — a single angular shard 2. **Processing phase:** The shard begins to rotate and multiply (kaleidoscope turning). Smooth, 1.5–2 seconds 3. **Reveal phase:** Fragments settle into a symmetric pattern. Reframed perspectives appear beneath This animation should become iconic — the "Kalei Turn" — recognizable in screenshots, marketing, and social media. ### Technical Specs - **Turn animation:** 1.5s ease-in-out rotation, fragments multiplying from 1→6→full symmetry - **Loading shimmer:** Prismatic color shift across a geometric skeleton screen - **Tab transitions:** Subtle faceted wipe (diagonal geometric transition) - **Pattern reveal:** Fragments drift into position with slight parallax depth (0.3s stagger per fragment) - **Fragment highlight (Mirror):** Amber glow fading in left-to-right after message sent, single subtle pulse, then ◇ icon appears --- ## Pattern System ### Procedural Generation Each reframing session generates a unique kaleidoscope pattern: - **Input text as seed** — same thought always generates the same base pattern (creates personal connection) - **Reframe variant as rotation** — Pattern 1, 2, 3 are visual rotations of the base - **Render using Canvas/WebGL** in React Native (or pre-rendered SVG) - **Deterministic** — reopening a saved reframe shows the same pattern - **Export:** 1080×1920 for Stories, 1080×1080 for feed posts ### Pattern Types | Source | Visual Style | Save Location | |--------|-------------|--------------| | **Turn pattern** | Sharp, geometric, high-contrast. Angular fragments in full symmetry. | Gallery → Turns | | **Mirror Reflection** | Softer geometry, organic curves blended with facets. Amber-dominant. | Gallery → Reflections | | **Growth pattern** (Spectrum) | Evolving complexity over time. Starts simple, gains layers and color range. | Spectrum dashboard | ### Pattern Cards (Sharing) When a user saves a reframe, they can generate a **Pattern Card** — a shareable image featuring their unique pattern, the reframed thought (never the original negative thought), and subtle Kalei branding. Designed for Instagram Story and iMessage formats. ### "Turn It" Sharing A user can share a prompt with a friend: "Turn this fragment" — challenging someone else to reframe a thought. This introduces new users through a natural, non-spammy mechanic. ### Community Gallery (Future) An opt-in public gallery where users share their best patterns anonymously. Browse how other people turned fragments into patterns. Upvote the most powerful reframes. --- ## Onboarding Flow The onboarding teaches the metaphor through experience, not explanation. **Screen 1 — The Fragment** Visual: A single shard of colored glass on a dark background. > **"This is a thought."** > *On its own, it can feel sharp. Random. Hard to make sense of.* **Screen 2 — The Turn** Visual: The shard multiplies and rotates into a kaleidoscope pattern. Animated. > **"But change the angle..."** > *...and the same piece becomes part of something beautiful.* **Screen 3 — The Reveal** Visual: A full, stunning kaleidoscope pattern fills the screen. > **"Kalei doesn't change your reality."** > *It changes how you see it.* **Screen 4 — First Turn (Interactive)** > **"Let's try your first Turn."** > *Type something that's been weighing on you.* The user types a real negative thought. Kalei processes it and returns 2–3 reframed perspectives. Core value proposition experienced within 60 seconds. **Screen 5 — Welcome** > **"Welcome to Kalei."** > *Every day is a new turn.* --- --- # Engagement & Monetization --- ## Notifications & Engagement Copy ### Daily Prompt (Push Notification) Rotate through styles: - "Ready for today's Turn? 🔮" - "Same pieces, new angle. What fragment are you carrying today?" - "Your Gallery is growing. Add today's pattern." - "The glass hasn't changed. But the view can. Take a Turn." ### Streak Maintenance - Day 3: "Three days of turning fragments into patterns. Keep going." - Day 7: "A week of new angles. Your Gallery is filling up." - Day 30: "30 days. 30 Turns. You're seeing things most people never will." - Streak broken: "The kaleidoscope is still here when you're ready. No pressure." ### Milestone Celebrations - First Turn: "Your first pattern. This is where it starts." - 10th Turn: "10 fragments turned into 10 beautiful patterns." - 50th Turn: "You've looked at 50 hard things and found something worth keeping in every one." - 100th Turn: "100 Turns. You don't just see the bright side — you see every side." ### Mirror-Specific Prompts For days when the user opens the Mirror but doesn't know what to write: - "What happened today that you're still thinking about?" - "What would you say to a friend if they were feeling what you're feeling?" - "What's one thing you're avoiding thinking about?" - "Describe your mood in a sentence. Then ask yourself why." ### Spectrum Notifications (Phase 2) **Weekly:** - "Your Spectrum shifted this week. Come see the colors." - "7 days of fragments and patterns. Here's what the light reveals." **Monthly:** - "A month of Turns. Your Spectrum has a story to tell." - "January's light, separated into its colors. Your monthly Spectrum is ready." **Milestone Insights:** - "Your fragment density dropped below 5 per 100 words for the first time. You're catching yourself." - "3 consecutive weeks of increasing agency in your writing. Something shifted." - "You haven't catastrophized in 12 days. That's your longest streak." **Growth Pattern Evolution:** - "Your pattern grew a new layer this month. Tap to see it." - "Remember your first pattern? Compare it to today's. Look how far you've come." ### Empty States | Screen | Copy | |--------|------| | Gallery (no saves) | "Your Gallery is waiting. The next pattern you save will appear here." | | Mirror (first open) | "Start writing. Say whatever's on your mind. Kalei will listen." | | Lens (no goal set) | "What are you focusing on? Set your first Lens." | | Turn history (new user) | "Every kaleidoscope starts with a single turn." | | Keepsakes (empty) | "No keepsakes yet. When a pattern feels worth keeping, you'll find it here." | --- ## Retention Strategy ### The Spectrum as Retention Engine (Phase 2) The Spectrum solves the biggest problem in wellness apps: **the drop-off after initial novelty fades.** **Week 1–2:** Users are engaged with the Mirror and Kaleidoscope. Everything is new. **Week 3–4:** Novelty fades. This is where most wellness apps lose people. **With the Spectrum** (launched when early users hit this exact window): - "Your first Spectrum is ready" re-engages users with a new reason to open the app - The evolving pattern creates **collection psychology** — users want to see it grow - Weekly insights create a **recurring appointment** with the app - Growth trajectory shows **concrete progress** — "this is working" evidence - Fragment tracking creates **self-competition** — users try to beat their own patterns - Monthly deep dives become **anticipated events** — not notifications to dismiss The Spectrum turns Kalei from a tool you use when you feel bad into a **dashboard you check because you're curious about yourself.** That's the difference between reactive usage (declining) and proactive usage (compounding). ### Mirror Streaks & Fragment Tracking Mirror streaks track separately from Turn streaks — Mirror sessions tend to be longer and more personal, making them a higher engagement signal. The Gallery shows **fragment patterns over time**: - "This month, your most common fragment type was **should statements**" - "You've reduced catastrophizing by 40% compared to last month" This turns the Mirror from a journal into a **self-awareness engine.** Users can literally see their thinking patterns change over time. ### Spectrum Launch Sequence **Pre-Launch (2 weeks before):** > "You've completed [X] Turns and [Y] Mirror sessions. Something new is coming that turns all of that into self-knowledge. Stay tuned." **Launch Day:** > "The Spectrum is here. Every Turn you've taken, every fragment you've noticed — it all means something. See your full emotional landscape for the first time." Open to a dramatic reveal of their personal Spectrum — the river visualization populating with historical data, the gem forming facets, the evolving pattern appearing. This should be a **wow moment.** --- ## Monetization ### Tier Structure | | **Kalei** (Free) | **Kalei Prism** ($7.99/mo) | |---|---|---| | **Kaleidoscope (Turn)** | 3 Turns per day | Unlimited | | | Basic pattern generation | Advanced reframe styles (Stoic, Compassionate, Pragmatic, Growth) | | | | Custom pattern themes | | **Mirror** | 2 sessions per week | Unlimited | | | Basic highlighting (3 distortion types) | Full spectrum (all 10 types) | | | 1 inline reframe per session | Unlimited reframes | | | Summary only | Full Reflection with insight | | | | Fragment tracking over time | | | | Export sessions | | **Lens** | Basic goal setting | Full Lens with AI-powered affirmations | | | | Vision board / The View | | **Gallery** | Last 30 days | Full history | | | | Export and share patterns | | **Spectrum** | Simplified weekly summary (1 insight, no visuals) | Full dashboard with all 5 components | | | Fragment type counts (basic numbers) | Weekly and monthly deep dives | | | | Growth trajectory and evolving pattern | | | | Rhythm detection + Turn impact | **Why "Prism":** A prism takes a single beam of light and splits it into its full spectrum. Kalei Prism gives you the full spectrum of features. **Upgrade CTAs:** - "See the full spectrum" - "Unlock your Prism" - (Spectrum-specific): "You've written 47 Mirror sessions and completed 23 Turns. There's a story in that data. See your full Spectrum." **Pricing Display:** > **Kalei Prism — $7.99/month** > *Unlimited Turns. Full Gallery. The Lens. Your complete spectrum.* The free tier gives enough access to experience the value. The paywall hits at the point where the user wants **depth and consistency** — exactly when they're most likely to convert. The Spectrum deepens this further in Phase 2 by requiring usage history to be valuable — by the time a user has enough data, they've already experienced Kalei's core value and are primed to convert. --- --- # Technical Architecture --- ## AI Processing Pipeline ### Mirror — Fragment Detection Each message the user sends triggers a lightweight AI analysis: ``` User message → Claude API call → Returns: { "fragments": [ { "text": "She probably thinks I'm not cut out for this role", "start_index": 89, "end_index": 143, "distortion_type": "mind_reading", "distortion_label": "Mind reading", "distortion_description": "Assuming someone else's thoughts without evidence", "confidence": 0.87 } ] } ``` **Confidence threshold:** Only highlight fragments with confidence > 0.75 to avoid false positives. A false positive would erode trust quickly. **Latency:** Analysis should complete within 1–2 seconds after message sent. Highlights appear with a subtle fade-in. ### Mirror — Reframe Generation (On Tap) When user taps a highlighted fragment: ``` Input: fragment text + surrounding context + distortion type Output: { "distortion_explanation": "Plain language explanation", "reframe": "1-2 sentence alternative perspective", "full_turn_prompt": "Pre-filled prompt for Kaleidoscope" } ``` --- ## Database Schema ### Mirror Tables ```sql CREATE TABLE mirror_sessions ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), user_id UUID REFERENCES users(id), started_at TIMESTAMPTZ DEFAULT NOW(), ended_at TIMESTAMPTZ, reflection_summary TEXT, reflection_insight TEXT, pattern_seed TEXT, created_at TIMESTAMPTZ DEFAULT NOW() ); CREATE TABLE mirror_messages ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), session_id UUID REFERENCES mirror_sessions(id), content TEXT NOT NULL, sequence_order INTEGER, created_at TIMESTAMPTZ DEFAULT NOW() ); CREATE TABLE mirror_fragments ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), message_id UUID REFERENCES mirror_messages(id), fragment_text TEXT NOT NULL, start_index INTEGER, end_index INTEGER, distortion_type VARCHAR(50), confidence FLOAT, was_tapped BOOLEAN DEFAULT FALSE, was_reframed BOOLEAN DEFAULT FALSE, reframe_text TEXT, created_at TIMESTAMPTZ DEFAULT NOW() ); ``` ### Spectrum Tables (Phase 2) ```sql CREATE TABLE spectrum_session_analysis ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), user_id UUID REFERENCES users(id), session_id UUID REFERENCES mirror_sessions(id), session_date DATE NOT NULL, valence FLOAT, -- -1 (negative) to 1 (positive) arousal FLOAT, -- -1 (calm) to 1 (activated) certainty FLOAT, -- -1 (uncertain) to 1 (confident) agency FLOAT, -- -1 (helpless) to 1 (in control) social_orientation FLOAT, -- -1 (isolated) to 1 (connected) temporal_focus FLOAT, -- -1 (past) to 0 (present) to 1 (future) fragment_count INTEGER, word_count INTEGER, dominant_distortion VARCHAR(50), created_at TIMESTAMPTZ DEFAULT NOW() ); CREATE TABLE spectrum_turn_analysis ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), user_id UUID REFERENCES users(id), turn_id UUID REFERENCES turns(id), turn_date DATE NOT NULL, pre_valence FLOAT, post_valence FLOAT, distortion_type VARCHAR(50), reframe_saved BOOLEAN, topic_cluster VARCHAR(100), created_at TIMESTAMPTZ DEFAULT NOW() ); CREATE TABLE spectrum_weekly ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), user_id UUID REFERENCES users(id), week_start DATE NOT NULL, avg_valence FLOAT, avg_arousal FLOAT, avg_agency FLOAT, total_fragments INTEGER, total_turns INTEGER, total_mirror_sessions INTEGER, dominant_distortion VARCHAR(50), distortion_distribution JSONB, fragment_density FLOAT, turn_impact_score FLOAT, insight_text TEXT, created_at TIMESTAMPTZ DEFAULT NOW(), UNIQUE(user_id, week_start) ); CREATE TABLE spectrum_monthly ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), user_id UUID REFERENCES users(id), month_start DATE NOT NULL, growth_score FLOAT, rhythm_insights JSONB, month_over_month_delta JSONB, top_fragment_types JSONB, most_impactful_turn UUID, pattern_complexity_score FLOAT, narrative_summary TEXT, created_at TIMESTAMPTZ DEFAULT NOW(), UNIQUE(user_id, month_start) ); ``` ### Data Processing Spectrum analysis runs as a **background job**, not in real-time: - After each Mirror session ends, emotional dimensions are computed and stored as numerical vectors — not raw text - Fragment types are already captured during Mirror sessions - Weekly aggregation job computes trends, rhythms, and insights - The Spectrum dashboard reads from aggregated data only --- ## Privacy & Safety Mirror and Spectrum content is the most personal data in the app. Trust is non-negotiable. ### Principles 1. **End-to-end encryption** for all Mirror content at rest 2. **No content used for model training** — explicit policy 3. **Local-first option** (future): Allow users to keep Mirror data on-device only 4. **Easy deletion**: User can delete any session or all Mirror data at any time 5. **Spectrum analyzes aggregated patterns, never exposes raw content.** It shows "your catastrophizing increased this week" — never "you wrote 'my life is falling apart' on Tuesday" 6. **No Spectrum data leaves the user's account.** Not for model training, not for research, not for anything 7. **Users control the analysis window.** They can exclude any session or Turn. They can limit analysis to the last 30/60/90 days 8. **Full deletion.** "Reset my Spectrum" erases all analyzed data and starts fresh 9. **Transparency.** A "How this works" section explains exactly what the AI analyzes and what it doesn't ### Content Safety If AI detects crisis language (self-harm, suicidal ideation), surface crisis resources immediately — not as a highlight/reframe, but as a dedicated intervention with hotline numbers and a warm handoff message. Kalei never reframes crisis-level distress. These are not fragments to be Turned. They are signals to provide immediate support. --- --- # Marketing --- ## Taglines | Context | Tagline | |---------|---------| | **Primary** | Same pieces. New angle. | | **Descriptive** | A kaleidoscope for your mind. | | **Action** | Turn how you see it. | | **Discovery** | Find the pattern. | | **Aspirational** | See every side. | ## Elevator Pitch > "Kalei is a kaleidoscope for your mind. Write freely in the Mirror and Kalei gently highlights the negative thinking patterns you can't see yourself. Take any thought into the Kaleidoscope and see it from entirely new angles. Then focus your clarity through the Lens toward the goals that matter to you. Same pieces. New angle. That's Kalei." ## App Store Description > **Kalei — A kaleidoscope for your mind.** > > A kaleidoscope doesn't change the glass. It changes the angle. Suddenly, broken fragments become a beautiful pattern. > > Kalei does the same thing with your thoughts. > > Type what's weighing on you. Kalei reveals new perspectives — not toxic positivity, but genuine, research-backed ways to see the same situation differently. Every reframe is grounded in cognitive behavioral science and built to help you think clearer, not just feel better. > > **The Mirror** — Write freely. Kalei listens and gently highlights the negative thinking patterns you can't see yourself. Tap any highlight to see it from a different angle. > > **The Kaleidoscope** — Turn any negative thought into multiple new perspectives. Same facts. Different angle. Beautiful patterns. > > **The Lens** — Set your focus. Define what you're building toward. Daily affirmations, vision tracking, and goal clarity powered by AI. > > **Your Gallery** — Every Turn creates a unique pattern. Save your favorites. Watch your collection grow. See how far you've come. > > Same pieces. New angle. That's Kalei. --- ## The Metaphor at Every Layer | Layer | How it shows up | |-------|-----------------| | **Name** | Kalei — short for kaleidoscope | | **Tagline** | Same pieces. New angle. | | **Core mechanic** | "Turn" a fragment into patterns | | **Visual design** | Jewel tones, geometric shapes, dark backgrounds, prismatic gradients | | **Animations** | Kaleidoscope rotation on every reframe | | **Vocabulary** | Fragments, patterns, turns, facets, gallery, keepsakes | | **Feature names** | The Mirror, The Kaleidoscope, The Lens, The Spectrum | | **Subscription** | Kalei Prism — "See the full spectrum" | | **Sharing** | Pattern Cards — unique generative art tied to each reframe | | **Notifications** | Poetic, grounded, always referencing angles and patterns | | **Brand voice** | Calm, wise, finds beauty in hard things | | **Onboarding** | User experiences a real Turn within 60 seconds | | **Retention** | Gallery of personal patterns grows over time — collectible, visual, meaningful | | **Phase 2** | The Spectrum completes the optical system — mirror, kaleidoscope, lens, prism | --- ## Feature Map — Full Ecosystem ``` PHASE 1 PHASE 2 ───────────────────────────────── ────────────────────── THE MIRROR (Awareness) ──→ feeds data to ──→ THE SPECTRUM Write freely (Intelligence) AI highlights fragments See your patterns Inline reframes Track growth Discover rhythms THE KALEIDOSCOPE (Perspective) ──→ feeds data to ──→ Measure impact Structured reframing Evolving visual Fragment → Patterns Save keepsakes THE LENS (Direction) ──→ informed by ──→ Goal setting Daily affirmations Vision tracking ◇ ◇ Kalei Free Kalei Prism 3 Turns/day Unlimited everything 2 Mirror/week + Full Spectrum Basic Lens + Weekly/monthly insights + Growth trajectory + Fragment analytics ``` --- *The glass hasn't changed. But you have.*