Huddl - Mental Health Therapy Platform

A HIPAA-compliant digital mental health platform for secure therapy sessions

---

🎯 Overview

Huddl is a HIPAA-compliant mental health therapy platform that connects patients with licensed therapists through secure video sessions, group therapy ("Huddls"), and 24/7 crisis intervention.

Key Features

• 🎥 Individual Therapy - Secure 1-on-1 video sessions with Daily.co WebRTC
• 👥 Group Therapy (Huddls) - Therapist-facilitated group sessions
• 🚨 Crisis Intervention - 24/7 emergency button with <60 second response
• 🏥 Clinical Access - Hospital-issued access codes for patient onboarding
• 📋 PHR System - Personal Health Records with encrypted storage
• 🔒 HIPAA Compliant - End-to-end encryption and audit logging

---

📁 Project Structure

Huddl/
├── huddl-app/               # Next.js application
│   ├── src/
│   │   ├── app/            # Pages and routes
│   │   ├── components/     # React components
│   │   ├── lib/            # Utilities and API
│   │   └── types/          # TypeScript types
│   └── database/           # SQL migrations
├── docs/                    # Technical documentation
├── infrastructure/          # Terraform configs
├── assets/                  # Architecture diagrams
└── .agent/                  # Multi-agent dev logs

---

🚀 Quick Start

Prerequisites

• Node.js 18+ or pnpm
• Supabase account
• Daily.co account (for video)

Installation

# Clone the repository
git clone https://github.com/anorak999/Huddl.git
cd Huddl/huddl-app

# Install dependencies
pnpm install

# Copy environment variables
cp .env.example .env.local

# Start development server
pnpm dev

Environment Setup

Configure your .env.local with:

NEXT_PUBLIC_SUPABASE_URL=your-supabase-url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-key
DAILY_API_KEY=your-daily-api-key

See docs/ENVIRONMENT_VARIABLES.md for full configuration.

---

🗄️ Database Setup

Run the consolidated setup script in Supabase SQL Editor:

-- Run: huddl-app/database/CONSOLIDATED_SETUP.sql

This creates all tables, RLS policies, and required columns.

---

📚 Documentation

Document	Description
huddl_prd.md	Product Requirements Document
GUIDELINES.md	Project roadmap and guidelines
docs/ENVIRONMENT_VARIABLES.md	Environment configuration
docs/SUPABASE_PRODUCTION_SETUP.md	Database setup guide
docs/SECURITY_AUDIT_CHECKLIST.md	Security requirements
VERCEL_DEPLOYMENT_GUIDE.md	Deployment instructions

---

🛠️ Tech Stack

Layer	Technology
Frontend	Next.js 15, React 19, TypeScript
Styling	Tailwind CSS, CSS Variables
Database	Supabase (PostgreSQL + RLS)
Auth	Supabase Auth + Access Codes
Video	Daily.co WebRTC
Email	Resend
Hosting	Vercel
Infrastructure	Terraform (AWS)

---

👥 User Roles

Role	Access
Patient	Book sessions, view PHR, crisis button
Therapist	Manage schedule, conduct sessions, write notes
Admin	Generate access codes, manage users

---

🔐 Security & Compliance

• ✅ Row Level Security (RLS) on all tables
• ✅ End-to-end encryption for video calls
• ✅ HIPAA-compliant data handling
• ✅ Audit logging for PHI access
• ✅ Secure session management

---

📊 Architecture

📄 License

MIT License - See huddl-app/LICENSE

---

Built by Himath Rajapaksha for mental health accessibility

© 2025 Suwasetha Hospital