SoulSync: India Resilience Hub 🇮🇳

Empowering students through AI-driven peer support and autonomous resilience tools.

Watch Demo Video • Live Project • Pitch Deck

---

📖 Table of Contents

• Inspiration
• The Vision (SDG Alignment)
• Key Features
• Architecture & Tech Stack
• Google Cloud Integrations
• Privacy & Governance
• App Navigation
• Project Structure
• Setup & Installation
• What's Next
• Team

---

Inspiration

In high-pressure academic environments, especially within Indian universities, students often face severe mental distress due to academic expectations, cultural stigma, and limited access to professional care. The tragic rise in student distress signals a gap between acute mental health crises and available support. SoulSync was born from the urgent need to bridge this gap, providing a "Zero-Trace", culturally sensitive, and highly accessible safety net.

The Vision (SDG Alignment)

SoulSync is purpose-built for the Google Solution Challenge 2026, meticulously aligning with the United Nations Sustainable Development Goals:

• SDG 3: Good Health & Well-being (Target 3.4): Promoting mental health through prevention, early intervention, and accessible peer-to-peer support networks.
• SDG 17: Partnerships for the Goals: Fostering a collaborative ecosystem that unites student volunteers, university administrations, and professional Indian mental health NGOs (e.g., Sangath, NIMHANS).

Key Features

SoulSync goes beyond a simple chat interface, offering a modular suite of interactive tools designed to stop panic in its tracks and foster long-term resilience:

1. The "Zero-Trace" Support Pipeline

• Absolute Anonymity: A custom useAnonymousIdentity pipeline ensures student privacy via local UUID persistence—no emails, no phone numbers, no tracking.
• Empathetic Peer Matching: Connects students with trained, verified student volunteers for real-time chat and support sessions.

2. AI-Powered "Supporter Command Center"

• Intelligent Handoff Briefings: Uses Google Gemini to analyze past (anonymous) interactions and generate concise, actionable briefings for volunteers before a session begins, ensuring continuity of care.
• Perspective API Safety Layer: Real-time sentiment and toxicity analysis to ensure all communications remain respectful, safe, and productive.

3. Interactive "Winner's Suite" Resilience Tools

• Breathing Visualizer: Guided, interactive respiratory regulation (e.g., 4-7-8 breathing) for immediate nervous system stabilization.
• Grounding Journey: An interactive 5-4-3-2-1 sensory exercise to help students reconnect with the physical world during moments of dissociation or panic.
• HALT Diagnostic: A specialized, campus-focused tool providing actionable recovery tips for when a student is Hungry, Angry, Lonely, or Tired.
• Reflection Pad: An ephemeral, "Zero-Trace" journaling space for quick emotional offloading.

4. Data-Driven "Healing Curve"

• Beautiful, Recharts-powered visual dashboards allowing students to track their emotional progress and mood trends over time in a secure, private environment.

Architecture & Tech Stack

SoulSync leverages a modern, scalable, and highly responsive technology stack to deliver a premium user experience:

• Frontend: React 18, Vite, TypeScript, Tailwind CSS
• Routing & State: TanStack Router (Type-safe routing), React Query
• UI/UX & Animations: Framer Motion (Premium emotional micro-animations), Lucide React (Icons)
• Backend & Database: Supabase (PostgreSQL, Auth, Storage), Row Level Security (RLS)

Google Cloud Integrations

• Google Gemini 1.5 Pro/Flash: Powers the core contextual engine for dialogue understanding and generating volunteer briefings.
• Google Perspective API: Acts as the primary safety net, automatically flagging toxic or distressed language for immediate clinical escalation.
• (Planned) Google Cloud Run: For scalable deployment of microservices.

Privacy & Governance

Database Schema & Security

The entire system architecture is built around "Privacy by Design", utilizing Supabase's powerful Row Level Security (RLS) to protect sensitive data:

• student_profiles: Anonymous alias tracking, protected from volunteer access; used strictly for AI memory context.
• mood_entries: Encrypted records of the student's emotional journey.
• session_bookings: Managed support sessions with secure meeting tokens.
• volunteers: A verified registry of student supporters with secure credential/CV storage.

Verification Hub

A master administrative portal for university counselors to manage volunteer onboarding, verify credentials, and monitor platform integrity without compromising student anonymity.

App Navigation

To help you evaluate SoulSync quickly, here are the key routes you should visit:

For Students:

• / - Landing Page (Hero, Value Proposition, SDG Alignment)
• /check-in - Daily Check-in & HALT Diagnostic
• /mood-tracker - Emotional Healing Curve & Mood History
• /peer-match - Connect securely with an anonymous volunteer
• /chat - Real-time support chat interface
• /resources - Interactive Resilience Tools (Breathing, Grounding, Reflection)
• /community-qna - Anonymous Community Q&A
• /partners - NGO Partners & Collaborators

For Volunteers & Admins:

• /volunteer - Volunteer Onboarding / Verification
• /volunteer/dashboard - Volunteer CRM, AI Command Center & Handoff Briefings
• /admin - Admin Portal
• /admin/volunteers - Volunteer Verification & Governance Hub
• /admin/command-center - System-wide crisis overview

Project Structure

soulsync/
├── src/
│   ├── components/       # Reusable UI components
│   │   ├── admin/        # Admin dashboard components
│   │   ├── resilience-tools/ # Breathing, Grounding, Reflection tools
│   │   ├── ui/           # Base UI elements (Tailwind/Radix)
│   │   └── volunteer/    # Volunteer CRM components
│   ├── routes/           # TanStack file-based routing
│   │   ├── admin/        # Admin panel pages
│   │   ├── api/          # Server-side API endpoints
│   │   └── volunteer/    # Volunteer dashboard pages
│   ├── integrations/     # Supabase client setup
│   ├── hooks/            # Custom React hooks (e.g., useAnonymousIdentity)
│   ├── lib/              # Utility functions
│   └── styles.css        # Global Tailwind CSS
├── supabase/
│   └── migrations/       # SQL schemas and RLS policies
├── package.json          # Project dependencies
└── vite.config.ts        # Vite configuration

Setup & Installation

Follow these steps to run SoulSync locally:

Prerequisites

• Bun (or Node.js/npm)
• A Supabase Project
• A Google Gemini API Key

Installation

1. Clone the repository:

   git clone https://github.com/your-org/soulsync.git
   cd soulsync

2. Install dependencies:

   bun install

3. Environment Variables: Create a .env file in the root directory and add the following:

   VITE_SUPABASE_URL=your_supabase_project_url
   VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
   GEMINI_API_KEY=your_gemini_api_key

4. Database Setup: Execute the SQL migration scripts located in the /supabase/migrations folder against your Supabase project to build the necessary schemas and RLS policies.

5. Run the development server:

   bun run dev

Built with for student resilience. Because no student should have to navigate their hardest days alone.