Skip to content

Techgethr/dissociative-support

Repository files navigation

🧠 Dissociative Support Platform

A comprehensive mental health and wellbeing platform designed specifically for individuals living with dissociative disorders. Built with modern web technologies to provide a safe, supportive, and feature-rich environment for managing mental health challenges.

🌟 Overview

Dissociative Support is a specialized digital platform that offers multiple tools and resources to help individuals with dissociative disorders manage their daily lives, track their wellbeing, and maintain their support networks. The platform combines evidence-based therapeutic techniques with modern technology to provide accessible mental health support.

✨ Key Features

πŸ“Š Journal & Mood Tracking

  • Daily mood logging with 1-10 scale
  • Personal journal entries with timestamp tracking
  • Visual mood trends and patterns
  • Secure, private data storage

πŸ‘₯ Emergency Contact Management

  • Store trusted emergency contacts
  • Automated notifications when user signs in (requires setup)
  • Email alerts for support network activation
  • Contact information management

πŸ’¬ AI-Powered Chat Support

  • 24/7 AI wellbeing assistant
  • Conversational support for immediate help
  • Crisis intervention guidance
  • Mental health coping strategies

🧘 Wellness Tools Collection

Grounding Techniques

  • 5-4-3-2-1 sensory grounding exercise
  • Physical grounding methods
  • Mental grounding strategies
  • Evidence-based dissociation management

Breathing Exercises

  • Interactive box breathing (4-4-4-4)
  • Guided breathing sessions
  • Visual breathing indicators
  • Customizable session durations

Focus Training

  • Concentration building exercises
  • Mindful observation practice
  • Breath counting techniques
  • Focus timer with multiple durations

Stress Reduction

  • Progressive muscle relaxation
  • Visualization techniques
  • Gratitude practice exercises
  • Multi-category stress management tools

🎨 Modern User Interface

  • Dark/light theme support
  • Responsive design for all devices
  • Accessible UI/UX design
  • Intuitive navigation with sidebar
  • Beautiful, calming color schemes

πŸ” Secure Authentication

  • WorkOS AuthKit integration
  • Secure session management
  • Protected routes and middleware
  • User data privacy protection

πŸ—οΈ Technical Architecture

Frontend Stack

  • Framework: Next.js 15 with App Router
  • Language: TypeScript for type safety
  • Styling: Tailwind CSS with custom design system
  • UI Components: React with modern hooks
  • State Management: React state with Convex real-time updates

Backend Stack

  • Database & Backend: Convex (real-time database, serverless functions)
  • Authentication: WorkOS AuthKit
  • Email Service: Resend for notifications
  • AI Integration: OpenAI API for chat support

Key Technical Features

  • Real-time Updates: Convex subscriptions for live data
  • Type Safety: Full TypeScript implementation
  • Serverless: No server management required
  • Scalable: Auto-scaling cloud infrastructure
  • Secure: End-to-end data encryption

πŸš€ Getting Started

Prerequisites

  • Node.js 18+ and npm
  • A code editor (VS Code recommended)
  • Git for version control

1. Clone and Install

# Clone the repository
git clone <repository-url>
cd dissociative-support

# Install dependencies
npm install

2. Environment Configuration

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

Edit .env.local with your configuration:

# WorkOS AuthKit Configuration
WORKOS_CLIENT_ID=your_client_id_here
WORKOS_API_KEY=your_api_key_here
WORKOS_COOKIE_PASSWORD=your_secure_password_here
NEXT_PUBLIC_WORKOS_REDIRECT_URI=http://localhost:3000/callback

# Email Notifications (Resend)
RESEND_API_KEY=your_resend_api_key_here
RESEND_FROM_EMAIL=your_verified_email@yourdomain.com

# Convex Backend
NEXT_PUBLIC_CONVEX_URL=your_convex_url_here

# AI Features (Optional)
OPENAI_API_KEY=your_openai_api_key_here

3. WorkOS Setup

  1. Create WorkOS Account: Visit workos.com and sign up
  2. Get Credentials: From WorkOS dashboard, copy Client ID and API Key
  3. Configure Redirect: Add http://localhost:3000/callback as redirect URI
  4. Generate Password: Create secure cookie password (32+ characters)

4. Convex Backend Setup

# Start Convex development
npx convex dev

This will:

  • Deploy your backend functions
  • Set up your database
  • Provide your Convex URL
  • Open the Convex dashboard

5. Email Service Setup (Resend)

  1. Create Resend Account: Visit resend.com
  2. Add API Key: Copy your API key to .env.local
  3. Verify Domain: Add and verify your sending domain
  4. Test Email: Send a test email to verify setup

6. Launch Application

# Start development servers
npm run dev

Visit http://localhost:3000 to access your platform!

πŸ“± Platform Features Guide

Dashboard Overview

  • Mood Statistics: Track your wellbeing trends
  • Recent Activity: Latest journal entries and interactions
  • Quick Actions: Fast access to key features
  • Support Network: Emergency contacts status

Journal System

  • Daily Logging: Record mood and thoughts
  • Historical View: Browse past entries
  • Search & Filter: Find specific entries
  • Export Options: Download your data (planned)

Emergency Contacts

  • Add Trusted Contacts: Family, friends, therapists
  • Automatic Alerts: Notifications when you sign in
  • Contact Management: Edit and remove contacts
  • Privacy First: Only you can see your contacts

AI Chat Support

  • 24/7 Availability: Always there when you need support
  • Crisis Guidance: Help during difficult moments
  • Coping Strategies: Evidence-based techniques
  • Conversational: Natural language interaction

Wellness Tools

  • Grounding: Stay present during dissociation
  • Breathing: Reduce anxiety and stress
  • Focus: Build concentration skills
  • Stress Relief: Multiple relaxation techniques

πŸ”’ Security & Privacy

Data Protection

  • End-to-End Encryption: All data encrypted in transit and at rest
  • GDPR Compliant: European privacy standards
  • HIPAA Ready: Healthcare data protection (in development)
  • Zero Trust: Minimal data exposure

User Privacy

  • Anonymous Usage: No personal data collection
  • Local Processing: Data stays on your device when possible
  • Secure Authentication: Industry-standard OAuth implementation
  • Transparent Policies: Clear privacy documentation

🀝 Support & Community

Getting Help

  • Documentation: Comprehensive setup and usage guides
  • Email Support: Direct assistance for technical issues
  • Community Forum: Connect with other users (planned)
  • Professional Resources: Links to mental health organizations

Contributing

We welcome contributions from developers, mental health professionals, and users:

  • Bug Reports: Help us improve stability
  • Feature Requests: Suggest new tools and improvements
  • Code Contributions: Help expand the platform
  • Documentation: Improve user guides and setup instructions

πŸ“Š Platform Statistics

Current Features

  • βœ… 6 Core Tools: Journal, Contacts, Chat, Grounding, Breathing, Focus
  • βœ… Responsive Design: Works on all devices
  • βœ… Multi-language Ready: Internationalization support
  • βœ… Theme Support: Dark and light modes
  • βœ… Real-time Sync: Instant data updates

Development Roadmap

  • πŸ”„ Data Export: PDF and CSV export options
  • πŸ”„ Mobile App: Native iOS and Android applications
  • πŸ”„ Professional Tools: Therapist dashboard and tools
  • πŸ”„ Community Features: User forums and peer support
  • πŸ”„ Advanced Analytics: Detailed wellbeing insights

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

  • Convex: For the amazing backend platform
  • WorkOS: For secure authentication solutions
  • Resend: For reliable email delivery
  • OpenAI: For AI-powered support features
  • Mental Health Community: For guidance and inspiration
  • Beta Testers: For valuable feedback and suggestions

Built with ❀️ for the mental health community

Releases

No releases published

Packages

 
 
 

Contributors