Quiet the spin. Organise the chaos. Finally breathe again.

Brain Dump is a compassionate mental wellness application that helps you slow down racing thoughts, explore your inner world through guided reflection, and gain clarity when your mind feels overwhelmed.

Brain Dump is a non-therapeutic support tool designed to help users manage overwhelming thoughts and emotions. Unlike traditional journaling apps, Brain Dump combines:

• 🎤 Voice & Text Input - Express your thoughts naturally through speech or typing
• 🤖 AI-Powered Analysis - Intelligent categorization and compassionate insights using GPT-4
• 🎯 Guided Reflection - 5-question framework to explore each thought mindfully
• 🗺️ Visual Mapping - Interactive thought bubble visualization organized by themes
• 🔊 Voice Narration - ElevenLabs text-to-speech guides you through reflection

The application helps you understand patterns in your thinking, identify emotions, and gain perspective on what's weighing on your mind—all in a safe, private, and judgment-free space.

• Next.js 13.5 - React framework with server-side rendering
• TypeScript - Type-safe development
• Tailwind CSS - Utility-first styling with animations
• Radix UI - Accessible component primitives
• Lucide React - Beautiful icon library

• OpenAI GPT-4 - Thought categorization and compassionate insights
• OpenAI Whisper - Speech-to-text transcription
• ElevenLabs - Natural text-to-speech voice narration

• Web Audio API - Real-time audio level visualization
• MediaRecorder API - Browser-based voice recording
• WebM Format - Optimized audio capture

• localStorage - Client-side session persistence
• React Hooks - Modern state management
• Supabase - Database (configured for future cloud sync)

graph TB
    Start([User Opens App]) --> Weather[Select Mind Weather]
    Weather --> Input[Input Page: Add Thoughts]

    Input --> Voice[Voice Recording]
    Input --> Text[Text Input]

    Voice --> Transcribe[OpenAI Whisper API]
    Transcribe --> Split[Smart Sentence Splitting]
    Split --> Store1[Store in localStorage]

    Text --> Store1

    Store1 --> Session[Session Page: Guided Reflection]

    Session --> Q1[Q1: Change or Accept?]
    Session --> Narrate[ElevenLabs TTS]
    Narrate --> PlayAudio[Play Question Audio]

    Q1 --> Q2[Q2: Helps or Hurts?]
    Q2 --> Q3[Q3: Strongest Feeling?]
    Q3 --> Q4[Q4: Most True Part?]
    Q4 --> Q5[Q5: Intensity Scale]

    Q5 --> NextThought{More Thoughts?}
    NextThought -->|Yes| Session
    NextThought -->|No| Categorize[Categorize All Thoughts]

    Categorize --> GPT4[OpenAI GPT-4 Analysis]
    GPT4 --> Categories[Assign Categories & Themes]

    Categories --> Visualize[Thoughts Visualization]
    Visualize --> Bubbles[Interactive Bubble Map]
    Visualize --> Insights[Top Emotions & Themes]
    Visualize --> Reflection[Overall AI Reflection]

    Reflection --> Complete[Completion Page]
    Complete --> Summary[Session Summary]
    Complete --> NewSession{Start New Session?}

    NewSession -->|Yes| Start
    NewSession -->|No| End([Done])

    style Start fill:#e1f5e1
    style Weather fill:#fff4e1
    style Voice fill:#e1f0ff
    style Text fill:#e1f0ff
    style GPT4 fill:#ffe1f0
    style Narrate fill:#ffe1f0
    style Complete fill:#e1f5e1
    style End fill:#e1f5e1

• Node.js 18+ and npm installed
• OpenAI API key (Get it here)
• ElevenLabs API key (Get it here)

1. Clone the repository

   git clone https://github.com/fozagtx/brainDump.git
   cd brainDump

2. Install dependencies

   npm install

3. Set up environment variables

   Create a .env.local file in the root directory:

   OPENAI_API_KEY=your_openai_api_key_here
   ELEVENLABS_API_KEY=your_elevenlabs_api_key_here

   See API_KEYS_SETUP.md for detailed configuration instructions.

4. Run the development server

   npm run dev

5. Open your browser

   Navigate to http://localhost:3000

brainDump/
├── app/                      # Next.js app directory
│   ├── api/                  # API routes
│   │   ├── transcribe/       # OpenAI Whisper speech-to-text
│   │   ├── categorize-thoughts/ # GPT-4 thought analysis
│   │   ├── narrate/          # ElevenLabs text-to-speech
│   │   └── analyze-thought/  # Individual thought insights
│   ├── input/[id]/           # Thought input page
│   ├── session/[id]/         # Guided reflection page
│   ├── thoughts/[id]/        # Thought visualization page
│   ├── complete/[id]/        # Session completion page
│   └── page.tsx              # Home page
├── components/               # React components
│   └── ui/                   # Radix UI components
├── lib/                      # Utility functions
│   ├── storage.ts            # localStorage helpers
│   └── utils.ts              # Helper functions
├── hooks/                    # Custom React hooks
├── public/                   # Static assets
└── tailwind.config.ts        # Tailwind configuration

• No data leaves your device except for AI processing
• API calls to OpenAI and ElevenLabs are encrypted
• No account required - fully anonymous
• Session data stored locally in your browser
• No tracking or analytics

This project is open source and available under the MIT License.

Brain Dump is not a substitute for professional mental health care. If you're experiencing a mental health crisis, please contact a qualified mental health professional or crisis helpline immediately.

• US Crisis Hotline: 988 (Suicide & Crisis Lifeline)
• Crisis Text Line: Text "HELLO" to 741741
• International: Find your local crisis line