Skip to content

About

A metal health support platform to help users track and assess their own metal and emotional state.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

You Matter — Mental Health Support Hub

Overview

You Matter is a comprehensive web application designed to provide mental health support and wellness resources for students and individuals. The platform offers self-assessment tools, mood tracking, journaling, AI-powered support, therapist consultations, stress-relief toolkits, and community connection features.

Features

1. Self-Assessment Tool

  • Quick mental health questionnaire to evaluate current state
  • Personalized recommendations based on assessment results
  • Tracks assessment history for users (when logged in)

2. Daily Mood Tracker

  • Log daily moods with 5 emotion levels (Happy, Good, Neutral, Anxious, Low)
  • Visual mood graph showing trends over time
  • Optional notes for each mood entry
  • Track emotional patterns and identify triggers

3. Instant Calm Toolkit

  • Box Breathing Exercise with guided animations
  • 5-4-3-2-1 Grounding Technique for anxiety management
  • Quick Stress Relief Methods (ice water, progressive relaxation, humming breath, etc.)
  • YouTube video links for each technique
  • Step-by-step instructions for each exercise

4. Anonymous Journal

  • Password-protected private journal entries
  • Create, read, edit, and delete entries
  • Tag entries with mood labels
  • Track personal thoughts and reflections
  • Timestamps for all entries

5. AI Mental Health Support

  • Chat with an AI assistant powered by the Vercel AI SDK
  • Empathetic responses for mental health concerns
  • Available 24/7 for users feeling down
  • Emergency resource suggestions

6. Find Therapists

  • Browse mental health professionals
  • View therapist credentials and specializations
  • Check availability and rates
  • Book consultations directly through the platform
  • Schedule appointments with preferred therapists

7. Community Support

  • Real-time peer-to-peer messaging
  • Connect with other users for mutual support
  • Anonymous messaging option
  • Delete your own messages
  • Supportive community guidelines

8. Emergency Helplines

  • Kiran Mental Health Helpline and other verified contacts
  • Quick access to crisis resources
  • Professional mental health support numbers

Technology Stack

Frontend

  • React with TypeScript for type-safe components
  • Next.js 16 for server-side rendering and API routes
  • Tailwind CSS for responsive design
  • Lucide React for icons
  • Framer Motion for animations
  • date-fns for date formatting

Backend & Database

  • Supabase (PostgreSQL) for data storage
  • Supabase Auth for user authentication
  • Supabase Realtime for live community chat
  • Row Level Security (RLS) for data protection

AI & APIs

  • Vercel AI SDK 6 for chatbot functionality
  • OpenAI as the default AI model provider

Installation & Setup

Prerequisites

  • Node.js (v18 or higher)
  • npm or pnpm package manager
  • Supabase account (free tier available)

Getting Started

  1. Clone the repository

    git clone https://github.com/akira-616/YouMatter_by_CodeHeist.git
    cd YouMatter_by_CodeHeist
  2. Install dependencies

    pnpm install
  3. Set up environment variables

    Create a .env.local file with:

    NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
    NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
    
  4. Run the development server

    pnpm dev
  5. Access the application

    Open http://localhost:3000 in your browser

Usage Guide

For New Users

  1. Visit the home page to explore available features
  2. Try the Self-Assessment tool (no login required)
  3. Use the Calm Toolkit for immediate stress relief
  4. Create an account to unlock personalized features

For Registered Users

  1. Track Your Mood: Log daily emotions and see visual trends
  2. Journal Privately: Create password-protected journal entries
  3. Get AI Support: Chat with the mental health AI assistant
  4. Find Help: Browse therapists and book consultations
  5. Connect: Join the community to support and be supported by others
  6. Access Profile: View your wellness journey and statistics

Navigation

  • Use the sidebar navigation to access different sections
  • Click the hamburger menu (☰) on mobile to toggle sidebar
  • Use the collapse button on desktop to minimize the sidebar
  • Quick access buttons on the home page for main features

Database Schema

Core Tables

profiles

  • Stores user profile information
  • Contains display name and creation date
  • Password-protected journal access

mood_entries

  • Tracks daily mood logs
  • Stores mood score (1-5), label, and optional notes
  • Timestamps for trend analysis

journal_entries

  • Stores journal entries with title, content, and mood tags
  • Tracks creation and update dates
  • User-specific with RLS protection

community_messages

  • Real-time community chat messages
  • User identification and timestamps
  • Allows message deletion by sender

File Structure

app/
  ├── page.tsx                 # Home page with all main sections
  ├── layout.tsx                # Root layout with metadata
  ├── globals.css                # Global styles and color tokens
  ├── auth/                      # Authentication pages
  │   ├── login/
  │   ├── sign-up/
  │   ├── sign-up-success/
  │   └── error/
  ├── api/
  │   ├── support/                # AI chatbot API
  │   └── assessment/             # Assessment storage API
  ├── profile/                    # User profile and settings
  ├── journal/                    # Journal management
  ├── therapists/                 # Therapist directory
  ├── ai-support/                 # AI chat interface
  └── community/                  # Community chat

components/
  ├── sidebar-nav.tsx          # Navigation sidebar
  ├── header.tsx                # Top header with login
  ├── toolkit-modal.tsx          # Calm toolkit modal
  ├── self-assessment.tsx        # Assessment component
  ├── mood-graph.tsx             # Mood trend visualization
  ├── journal-*.tsx               # Journal components
  ├── booking-modal.tsx           # Therapist booking
  ├── community-chat-client.tsx   # Community messaging
  └── ui/                         # shadcn UI components

lib/
  ├── supabase/                # Supabase client setup
  └── utils.ts                  # Utility functions

Key Features Explained

Password-Protected Journal

Users can set a password in their profile security settings. The journal requires password verification before viewing entries, with passwords secured using bcrypt hashing.

Real-time Community Chat

Built with Supabase Realtime subscriptions for instant message delivery. Messages sync across all connected users in real-time with RLS policies ensuring users only see messages they're allowed to see.

AI Mental Health Support

The AI chatbot uses the Vercel AI SDK with streaming responses. It provides empathetic, supportive guidance and suggests professional help when appropriate. The system prompt is configured to be supportive and non-judgmental.

Mood Tracking with Visualization

Mood entries are stored with timestamps. The mood graph component visualizes trends over time, helping users identify patterns and triggers.

Authentication & Security

  • Email/Password authentication via Supabase Auth
  • Row Level Security (RLS) policies on user data tables
  • Per-user data scoping ensures users only access their own data
  • Password-protected journal with bcrypt hashing
  • Optional email confirmation for account security

Deployment

Deploy to Vercel (Recommended)

  1. Push code to GitHub
  2. Connect GitHub repository to Vercel
  3. Add environment variables in Vercel dashboard
  4. Vercel automatically deploys on push to main branch

Manual Deployment

pnpm build
pnpm start

Browser Support

  • Chrome (latest)
  • Firefox (latest)
  • Safari (latest)
  • Edge (latest)
  • Mobile browsers (iOS Safari, Chrome Mobile)

Future Enhancements

  • Video consultations with therapists
  • Integration with wearable devices for mood tracking
  • Advanced analytics and insights
  • Support groups and group therapy sessions
  • Medication reminders
  • Sleep tracking
  • Exercise recommendations based on mood
  • Integration with crisis hotlines

Support & Resources

  • Emergency: Use the emergency helplines section
  • Technical Issues: Check the GitHub issues page
  • Mental Health Crisis: Please reach out to professional services

License

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

Disclaimer

This application is designed to complement, not replace, professional mental health care. If you're experiencing a mental health crisis, please contact emergency services or a mental health professional immediately.


Last Updated: June 2026 Version: 1.0.0

About

A metal health support platform to help users track and assess their own metal and emotional state.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages