A student-only collaboration & community platform — communities, social feed, project collaboration, study materials, study rooms, notifications. Mobile-first, dark-by-default, modular monolith.
- Frontend — Next.js 15 (App Router), TypeScript, TailwindCSS v4, shadcn-style primitives, Zustand, TanStack Query, Framer Motion
- Backend — Node.js + Fastify, Mercurius (GraphQL), Prisma, WebSockets
- Database — PostgreSQL 16
- Storage — pluggable driver (local in dev, S3/R2 ready)
- Auth — Email + password, college-email gate, JWT access + rotating refresh tokens
braventex/
├── apps/
│ ├── api/ # Fastify + Mercurius + Prisma backend
│ └── web/ # Next.js 15 frontend
├── docker-compose.yml
└── .env.example
Prerequisites: Node 20+, pnpm 10+, Docker.
# 1. Install deps
pnpm install
# 2. Bring up Postgres
pnpm db:up
# 3. Configure env
cp .env.example apps/api/.env
cp .env.example apps/web/.env.local
# 4. Run Prisma migrations + seed
pnpm prisma:migrate
pnpm prisma:seed
# 5. Start dev servers
pnpm dev- API: http://localhost:4000
- GraphQL playground: http://localhost:4000/graphiql
- Web: http://localhost:3000
- Adminer (DB GUI): http://localhost:8080
pnpm api:dev— run API onlypnpm web:dev— run Web onlypnpm prisma:studio— Prisma Studiopnpm typecheck— typecheck all packagespnpm lint— lint all packages
- College-email-verified signup, JWT auth, onboarding
- Communities (create / join / leave / search)
- Social feed — text/image/markdown/link posts, like / comment / bookmark / share
- Collaboration posts — "Looking for collaborators" with applications
- Study materials — upload PDFs / notes / links, filter by college/dept/semester/subject
- Study rooms — virtual rooms with chat + pomodoro (no audio/video in MVP)
- Notifications — in-app + WebSocket realtime
- Global search
- Analytics event log (recommendation-ready)
- Admin dashboard — bans, removals, reports, analytics
See DEPLOY.md for a step-by-step production deploy guide to braventex.in (Vercel + Railway + Neon + Cloudflare R2 + Resend + GoDaddy DNS).
Modular monolith. Backend organised by feature module (auth, user, community, post, studyMaterial, studyRoom, notification, search, admin). Each module owns a slice of GraphQL schema, resolvers, services, and Prisma access. Cross-cutting infra (storage, event bus, WS manager, logger, errors, JWT) lives in core/.
Event bus is in-process for MVP — drop in Redis/NATS later without changing call sites. Analytics events are persisted as rows in AnalyticsEvent so they're immediately queryable for future recommendation systems.