# Reframe — Full Content for AI Understanding

## App Identity

Name: Reframe
Tagline: Reframe your thoughts. Reclaim your peace.
URL: https://thoughtrecord.net
Type: Web Application (Progressive Web App + Android via Capacitor)
Category: Health & Wellness / Mental Health / Cognitive Behavioral Therapy
License: MIT
Repository: https://github.com/anomalyco/cbt-reframe

## Description

Reframe is a clinically-accurate, privacy-first CBT (Cognitive Behavioral Therapy) thought
record tool. It provides a structured 9-step guided process to help users catch automatic
negative thoughts, identify cognitive distortions, gather evidence for and against, and
build healthier, more balanced alternative thoughts.

Key differentiators:
- Anonymous-first: No email or password required. Users get a randomly generated name and
  a recovery code. Sessions persist via localStorage. Optional email conversion.
- Privacy: No tracking (uses Plausible, a privacy-friendly analytics service). No ads.
  No data selling. Data is encrypted in transit and at rest via Supabase.
- Freemium: Free tier includes unlimited thought records, cognitive distortion tagging,
  mood entries, coping cards, therapist sharing, and quiz-based learning. Pro tier adds
  offline grace period, share link management, PDF export.
- Therapist-ready: Password-protected share links. Therapist views records without an account.
- Cross-platform: Web (SvelteKit 5 + Vercel) and Android (Capacitor WebView). Same codebase.
- Evidence-based: Uses Aaron Beck's 7-column thought record model, Socratic questioning,
  and CBT psychoeducation.

## Features

### Core CBT Journaling
- 9-step guided thought record wizard with Socratic prompts
- 15 cognitive distortion categories with descriptions and examples
- Emotion intensity tracking (before/after reframing)
- Belief percentage tracking (before/after)
- Local draft auto-save during journaling (2-second debounce to localStorage)

### Mood Tracking
- Quick mood check-in (5 emoji states)
- Mood trend visualization over time

### Learning & Programs
- Interactive quiz-based learning module (30 questions across 4 topics)
- Guided CBT programs (3 programs, 14 days of daily content)
- Cognitive distortion reference guide

### Coping Cards
- 6 emergency grounding exercises (5-4-3-2-1, Box Breathing, Thought Stopping,
  Self-Compassion Break, Worst/Best Case, Progressive Relaxation)
- Accessible from every page via crisis banner or /help

### Data & Export
- JSON export of all records
- PDF export (single or batch with checkbox selection)
- Share links: password-protected, rate-limited, revocable

### Analytics & Insights
- Calendar heatmap of activity
- Insight cards replacing gamification (cognitive insight generation instead of XP/levels)
- Shift meter showing belief change before/after reframing

### Cross-Platform
- Responsive PWA: installable on any device
- Android APK: Capacitor WebView wrapper, 4.3 MB, min SDK 24
- Offline draft: Unsaved entries persist in localStorage

## Anonymous System

Users receive a randomly-generated display name (adjective + noun, e.g., "QuietFox")
and a recovery code (color-word-animal-number, e.g., "blue-canyon-27").

The recovery code IS the user's password. The email is deterministically derived from
the recovery code (hash → `anon_XXXXXXXX@reframe.anon`). This means:
- The user only needs their recovery code to log back in
- No email is ever sent to anonymous users
- If the recovery code is lost AND browser data is cleared, the account is permanently gone
- Recovery codes have ~17K possible combinations; Supabase rate limiting protects the login endpoint

Anonymous users can convert to email accounts via Settings → "Convert to email account".
The conversion Edge Function at supabase/functions/convert-account migrates all data
(thought_records, subscriptions, programs, etc.) from the anonymous Supabase user to a new
email-based user, then deletes the old anon user. Password strength is enforced (min 8 chars,
uppercase, number).

## Pro Tier

- Share link management (view all active links, revoke)
- Batch PDF export
- Offline grace period (14-day cached entitlement)
- Pro badge on premium features

Pricing is handled via LemonSqueezy (checkout URL, webhook endpoint at /api/lemon-squeezy).
The subscriptions table stores tier status and grace_period_end. The entitlement.ts service
checks tier server-side via Supabase and caches the result (14-day offline grace).

## Technical Architecture

- Frontend: SvelteKit 5 (Svelte runes) + TypeScript + Tailwind CSS v4
- Backend: Supabase (PostgreSQL + Auth + Edge Functions)
- Hosting: Vercel (free tier) for Web, Capacitor for Android
- Payments: LemonSqueezy webhook integration
- Analytics: Plausible (privacy-friendly, no cookies)
- Mobile: Capacitor with @capacitor/browser and @capacitor/clipboard plugins
- Design system: CSS-first tokens (oklch) via @theme, no hardcoded colors
- Font: Hanken Grotesk (Google Fonts)

Database tables: thought_records, mood_entries, shared_links, user_program_progress,
quiz_scores, subscriptions, feedback. Row-Level Security (RLS) on all tables.

## Blog Posts

1. "What Is a CBT Thought Record? A Beginner's Guide"
   - URL: /blog/what-is-cbt-thought-record
   - Covers: 7-column format, why thought records work, how Reframe simplifies the process

2. "15 Cognitive Distortions That Shape Your Thinking"
   - URL: /blog/cognitive-distortions-explained
   - Covers: All 15 distortions with real-world examples, how to use this knowledge

3. "5 Journaling Techniques That Reduce Anxiety"
   - URL: /blog/anxiety-journaling-techniques
   - Covers: Brain dump, ABCDE method, worst/best/most-likely, gratitude pairing, observer exercise

4. "How to Share Your Thought Records With Your Therapist"
   - URL: /blog/sharing-with-therapist
   - Covers: Why between-session sharing matters, how Reframe's share links work, privacy first

5. "CBT vs DBT vs ACT: Which Therapy Approach Is Right for You?"
   - URL: /blog/cbt-vs-dbt-vs-act
   - Covers: Comparison of CBT, DBT, ACT — which is best for anxiety, depression, emotional regulation

## Competitive Context

Reframe competes in the CBT/digital health space alongside:
- Thought Diary (iOS/Android, paid, tracked)
- Woebot (AI chatbot, subscription, data collection concerns)
- Moodfit (tracking-heavy, freemium with limits)
- CBT Thought Record Diary (simple, limited features)

Reframe's advantages: 100% anonymous, no tracking/PII, free tier with no record limits,
therapist sharing without account requirements, cross-platform from single codebase.