🧠 ADHD Buddy

Transform chaos into action with your voice.

ADHD Buddy is an open-source, voice-first productivity companion designed specifically for neurodivergent individuals and people with ADHD. Users record raw voice "brain dumps"; AI extracts actionable tasks, estimates durations, assigns priorities, and populates a single-task-focus board with gentle, guilt-free nudges and mood-tracked audio journaling.

---

✨ Features

• 🎙️ Voice Brain Dump: Tap the pulse button, speak freely without worrying about structure or tangents, and let AI structure your thoughts.
• ⚡ AI Task Extraction: Automatically identifies tasks, estimates durations (in minutes), suggests priorities, and flags tangents.
• 🎯 Single-Task Focus Board: High-visibility focus card with circular timer countdown to combat time blindness.
• 🕊️ Guilt-Free Rescheduling: One-tap "Later" action with zero shame or red warning walls.
• 📖 Audio Diary & Mood Tracking: Private audio reflection entries tagged with natural mood states (Bright, Steady, Foggy, Heavy, Tender).
• 🎨 Calm Paper Design System: High-contrast, accessibility-first theme (#FBF8F3 warm paper base, #1E6357 moss teal, #E86440 voice coral accent) using Google Fonts Bricolage Grotesque, Atkinson Hyperlegible, and Spline Sans Mono.

---

🎨 Design System Principles

1. Reduce Cognitive Friction: Minimal UI chrome, no visual clutter or overwhelming gradients.
2. Combat Time Blindness: Monospaced timers and prominent countdown rings visible at all times during active tasks.
3. Prevent Overwhelm: Single-task cards instead of intimidating endless task queues.
4. Forgive Interruptions & Zero Guilt: Rescheduling carries no penalties; language is encouraging and supportive.

---

🏗️ Monorepo Structure

adhd-buddy-app/
├── apps/
│   ├── web/           # React 18 + Vite web app (TypeScript & Tailwind/CSS System)
│   └── api/           # Express + Supabase backend services
├── packages/
│   └── shared/        # Shared TypeScript interfaces, types & validation schemas
├── supabase/
│   └── migrations/    # Database schema & RLS security policies
├── pnpm-workspace.yaml
└── package.json

---

🚀 Quick Start (Local Development)

Prerequisites

• Node.js >= 18
• pnpm >= 8 (npm i -g pnpm)

Installation

1. Clone the repository:

   git clone https://github.com/macaddy2/adhd-buddy-app.git
   cd adhd-buddy-app

2. Install dependencies:

   pnpm install

3. Build shared packages:

   pnpm --filter @adhd-buddy/shared build

4. Start local dev server:

   pnpm --filter web dev

   Open your browser at http://localhost:5173.

---

🧪 Testing & Build Verification

Run TypeScript type-checking and production build:

pnpm --filter web build

---

🤝 Contributing

We welcome contributions from everyone! Please read our Contributing Guide and Code of Conduct before submitting pull requests.

---

📄 License

Distributed under the MIT License. See LICENSE for more information.