MindBridge 🧠💙

MindBridge is an AI-powered mental wellness platform designed to provide users with a safe space for reflection, emotional support, and mood tracking. It combines conversational AI with mood analytics to help users better understand their emotional patterns over time and connect with appropriate support resources when needed.

Features

• 🤖 AI companion powered by Groq
• 😊 Mood logging and tracking
• 📈 Mood trends and insights
• 💬 Persistent conversations
• 🔐 Secure authentication with NextAuth
• 📊 Analytics dashboard
• 🩺 Specialist recommendations based on emotional patterns
• 🧠 AI-generated wellness insights
• 🌙 Responsive and modern UI

Disclaimer: MindBridge is intended to support mental wellness and self-awareness. It is not a substitute for professional medical advice, diagnosis, or treatment.

---

Tech Stack

Frontend

• Next.js (App Router)
• React
• TypeScript
• Tailwind CSS

Backend

• Next.js Server Actions / API Routes
• Prisma ORM
• PostgreSQL
• NextAuth

AI

• Groq API

---

Getting Started

Prerequisites

Make sure you have installed:

• Node.js 18+
• npm, pnpm, yarn, or bun
• PostgreSQL

---

Installation

Clone the repository:

git clone https://github.com/dev-eyitayo/mindbridge
cd mindbridge

Install dependencies:

npm install

---

Environment Variables

Create a .env file in the root directory and configure the required variables:

NEXTAUTH_URL=
NEXTAUTH_SECRET=
GROQ_API_KEY=
DATABASE_URL = 

---

Database Setup

Generate the Prisma client:

npx prisma generate

Run migrations:

npx prisma migrate dev

Seed the database:

npx prisma db seed

---

Running the Development Server

npm run dev

Open:

http://localhost:3000

The application automatically reloads as changes are made.

---

Project Structure

app/
components/
lib/
prisma/
public/
types/
hooks/
services/

The structure may evolve as new features are added.

---

Core Modules

AI Chat

Users can engage in supportive conversations powered by Groq.

Mood Tracking

Track moods, intensity levels, and emotional trends over time.

Insights

Receive AI-generated summaries and wellness observations based on mood history.

Journal

Maintain personal reflections and emotional notes.

Support & Specialists

Discover therapists and mental health specialists based on emotional patterns and needs.

---

Scripts

Start development server:

npm run dev

Build the application:

npm run build

Run production server:

npm run start

Generate Prisma client:

npx prisma generate

Run migrations:

npx prisma migrate dev

Open Prisma Studio:

npx prisma studio

Seed database:

npx prisma db seed

---