Skip to content

deepaksoni47/mind-connect

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 

Repository files navigation

MindConnect banner

Typing intro

MVP Next.js Node Express MongoDB Socket.IO Focus

Problem Statement

Recent student mental health survey insights indicate a critical support gap:

  • 69% of students feel always or often stressed
  • 38% have no one to talk to
  • 92% are not using any digital mental health support
  • 71.7% cite trust and privacy concerns as the main barrier

Students face academic pressure, anxiety, burnout, relationship stress, and career uncertainty, while existing support is often stigmatized, expensive, or delayed until crisis.

The core challenge is clear: a safe, anonymous, and structured early intervention system is missing.

Mission

MindConnect delivers a layered, privacy-first emotional support flow designed for early intervention:

AI Support → Trained Peer Support → Professional Counselor Support → Crisis Escalation

Solution Overview

1. AI Emotional Support

  • Real-time empathetic chat
  • Guided grounding and stress-relief support
  • Risk signal detection for distress and self-harm patterns
  • Ethical boundaries: no diagnosis, no medical prescriptions

2. Trained Peer Support

  • Verified peer listeners with role-based access
  • Structured peer chat sessions and availability queueing
  • Escalation hooks when higher-level care is needed

3. Professional Counselor Support

  • Counselor auth, dashboard, and availability management
  • Booking and session lifecycle features
  • Escalation, crisis, and session-note workflows

Key Features

  • Anonymous onboarding and token-based sessions
  • AI-assisted emotional support with moderation safeguards
  • Peer support workflow with routing and assignment logic
  • Counselor session and escalation pipeline
  • Encrypted journaling module
  • Community stories and moderation layer
  • Guided tools for breathing/grounding and coping
  • Crisis support prompts and escalation pathways
  • Realtime messaging and events via Socket.IO

Why It Stands Out

  • Layered escalation architecture, not a single chat lane
  • Safety-first design over engagement-first design
  • Anonymous-by-default identity flow
  • Structured peer and counselor operations
  • Practical institutional readiness via modular backend APIs

Architecture

flowchart LR
		A[Anonymous Student] --> B[Frontend App\nNext.js + Tailwind]
		B --> C[MindConnect API\nExpress + TypeScript]
		C --> D[AI Support + Moderation]
		C --> E[Peer Support System]
		C --> F[Counselor System]
		C --> G[Crisis & Escalation Engine]
		C --> H[(MongoDB)]
		C --> I[(Redis Queue)]
		B <--> J[Socket.IO Realtime Channels]
		J <--> C

		D --> G
		E --> G
		F --> G
Loading

Tech Stack

Frontend

  • Next.js 16
  • React 19
  • Tailwind CSS
  • Radix UI components
  • Socket.IO Client

Backend

  • Node.js + Express + TypeScript
  • MongoDB (Mongoose)
  • Socket.IO
  • JWT-based authentication
  • Zod validation and modular service architecture

AI & Safety

  • AI gateway integration (configurable provider keys)
  • Prompt templates and response filtering
  • Moderation engine with risk interpretation and escalation hooks

Repository Structure

mind-connect/
├─ frontend/        # Next.js client app (student/peer/counselor UI)
├─ backend/         # Express API, modules, sockets, and services
└─ README.md

Quick Start

Prerequisites

  • Node.js 18+
  • npm
  • MongoDB (local or cloud)
  • Redis (recommended for queue/availability workflows)

1) Clone and Install

git clone <your-repository-url>
cd mind-connect

cd backend && npm install
cd ../frontend && npm install

2) Configure Environment

Backend env file:

cd backend
cp .env.example .env

Important backend variables:

  • PORT
  • NODE_ENV
  • DATABASE_URL
  • JWT_SECRET
  • JWT_EXPIRES_IN
  • CORS_ORIGIN
  • JOURNAL_ENCRYPTION_KEY
  • REDIS_URL
  • AI_PROVIDER_KEY (or provider-specific key)
  • COUNSELORSESSION* payment/session configs

Frontend env file (create manually):

cd frontend
echo NEXT_PUBLIC_API_BASE_URL=http://localhost:4000/api/v1 > .env.local

3) Run in Development

Terminal 1:

cd backend
npm run dev

Terminal 2:

cd frontend
npm run dev

App endpoints:

Scripts

Backend

  • npm run dev
  • npm run build
  • npm run start
  • npm run test
  • npm run lint

Frontend

  • npm run dev
  • npm run build
  • npm run start
  • npm run lint

API Surface (Highlights)

  • Anonymous auth and session creation
  • Chat lifecycle and message history
  • Peer auth, dashboard, availability, and chat routes
  • Counselor auth, availability, booking, sessions, notes, escalation
  • Journal, tools, support, crisis, community, admin, and payments modules

Detailed API examples are available in backend/API.md.

Security & Privacy Principles

  • Anonymous-first identity model
  • Minimal sensitive data exposure
  • Encrypted journal workflow support
  • CORS controls and secure middleware defaults
  • Structured escalation for high-risk conversations

Expected Impact

Short Term

  • Earlier emotional support access
  • Reduced isolation among students
  • Better triage of high-risk signals

Long Term

  • Campus-wide deployment potential
  • Reduced crisis-stage interventions
  • Better normalization of help-seeking behavior

Team

  • Deepak Soni (Team Lead)
  • Aparna Banpela
  • Nitin Maurya
  • Jeet Kumar

Disclaimer

MindConnect is not a medical diagnosis or treatment platform.

It is designed as an early-support bridge for safe expression, guided coping, and timely escalation to appropriate human support.

Future Scope

  • Personalized AI guidance based on user interaction patterns
  • Institutional dashboards for universities and coaching ecosystems
  • Peer training certification workflows
  • Multi-language support
  • Helpline and partner ecosystem integrations
footer

MindConnect • Built to make support feel safe, early, and reachable.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors