GitHunt
ZA

ZackSatrday/Mental-health-app

A comprehensive digital platform designed to support student mental wellness through AI-guided assistance, professional counseling, and peer community connections.

SukunSetu - Student Mental Health Support Platform

A comprehensive digital platform designed to support student mental wellness through AI-guided assistance, professional counseling, and peer community connections.

๐ŸŒŸ Features

Core Functionality

  • AI-Guided First Aid Chat - Instant mental health support with AI-powered conversations
  • Confidential Counselor Booking - Secure booking system for professional mental health counselors
  • Resource Hub - Curated mental health videos, guides, and educational content
  • Peer Support Forum - Safe community space for students to connect and share experiences
  • Admin Analytics Dashboard - Insights and trends for administrators to track wellness metrics

User Experience

  • Multi-language Support - Available in English, Hindi, and Tamil
  • Dark/Light Theme - Responsive theme switching for user comfort
  • Mobile Responsive - Optimized for all device sizes
  • Accessibility Compliant - Built with accessibility standards in mind

๐Ÿš€ Getting Started

Prerequisites

  • Node.js (v14 or higher)
  • npm or yarn package manager

Installation

  1. Clone the repository
git clone <repository-url>
cd mental-health-app
  1. Install dependencies
npm install
  1. Start the development server
npm run dev
  1. Open your browser and navigate to http://localhost:3000

๐Ÿ› ๏ธ Technology Stack

  • Frontend Framework: React 18
  • Styling: Tailwind CSS with custom design system
  • UI Components: Custom component library with Radix UI primitives
  • Animations: Framer Motion
  • Icons: Lucide React
  • Build Tool: Vite
  • Language: JavaScript/JSX

๐Ÿ“ฑ Pages & Navigation

Main Pages

  • Landing Page - Hero section, features overview, demo, and FAQ
  • About Page - Mission, vision, and core values
  • Resources Page - Mental health resources and crisis support
  • Login/Signup - User authentication pages

Key Sections

  • Hero Section - Main call-to-action with animated illustrations
  • Features Section - Comprehensive overview of platform capabilities
  • Demo Section - Interactive AI chat demonstration
  • FAQ Section - Common questions and answers

๐ŸŽจ Design System

Colors

  • Primary: Cyan (500/400 variants)
  • Secondary: Green (500/400 variants)
  • Background: Gray-100/Slate-900 (light/dark)
  • Text: Gray-800/Slate-100 (light/dark)

Typography

  • Headings: Poppins font family
  • Body Text: Inter font family
  • Accent: Merriweather serif font

Components

  • Consistent button styles with hover states
  • Card-based layouts with shadows
  • Responsive navigation with mobile menu
  • Form inputs with focus states

๐ŸŒ Internationalization

The app supports multiple languages:

  • English (en) - Default language
  • Hindi (hi) - เคนเคฟเค‚เคฆเฅ€ support
  • Tamil (ta) - เฎคเฎฎเฎฟเฎดเฏ support

Language switching is available in the navbar and persists across sessions.

๐Ÿ”’ Privacy & Security

  • End-to-end encryption for sensitive data
  • Secure authentication system
  • Privacy-compliant data handling
  • Confidential counselor booking system

๐Ÿ“Š Admin Features

  • Analytics dashboard for usage tracking
  • Wellness trends monitoring
  • User engagement metrics
  • Resource utilization reports

๐Ÿค Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/new-feature)
  3. Commit your changes (git commit -m 'Add new feature')
  4. Push to the branch (git push origin feature/new-feature)
  5. Open a Pull Request

๐Ÿ“„ License

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

๐Ÿ†˜ Crisis Support

If you or someone you know is experiencing a mental health crisis, please reach out for immediate help:

  • National Crisis Helpline:
  • Emergency Services: 911 (US) or your local emergency number
  • Campus Counseling Services:

๐Ÿ“ž Contact

For questions, support, or feedback:


SukunSetu - Supporting student mental wellness through technology and compassion.

ยฉ 2025 SukunSetu. All rights reserved.