MindBridge

A peer support web app that forms small, psychologically safe peer circles with structured prompts and safety guardrails.

Project Structure

MindBridge/
├── frontend/          # React + Vite + TypeScript + Tailwind v4 + Zustand
├── backend/           # Go + Gin Framework
└── docker/            # Docker configurations

Tech Stack

Frontend

• React with Vite
• TypeScript
• Tailwind CSS v4
• Zustand (state management)

Backend

• Go (Golang)
• Gin Web Framework
• Prisma ORM

Database

• PostgreSQL (NeonDB Cloud)

Getting Started

Prerequisites

• Node.js (v20+)
• Go (v1.21+)
• pnpm (recommended)

Quick Setup

1. Setup Backend

   cd backend
   cp .env.example .env  # NeonDB connection is pre-configured
   go mod download
   go run github.com/steebchen/prisma-client-go db push
   go run main.go

2. Setup Frontend (in a new terminal)

   cd frontend
   pnpm install
   cp .env.example .env # optional, configure API base URL
   pnpm dev

Access Points

• Frontend: http://localhost:5173
• Backend API: http://localhost:8080
• PostgreSQL: NeonDB Cloud (managed)
• API Health Check: http://localhost:8080/api/health

Useful Commands

# View database GUI (Prisma Studio)
cd backend && go run github.com/steebchen/prisma-client-go studio

# Push schema changes to database
cd backend && go run github.com/steebchen/prisma-client-go db push

# Generate Prisma client
cd backend && go run github.com/steebchen/prisma-client-go generate

For detailed setup instructions, see SETUP.md

License

MIT