Open Source · MIT License

Build with Acadex

A full-stack classroom platform for note sharing, live group chat, CR-led moderation, and an AI study assistant grounded in your class materials. Clone both repos, configure your environment, and run locally — or explore the live deployment.

Next.js 16React 19TypeScriptTailwind CSS 4Shadcn UIExpress 5Prisma 7PostgreSQLpgvectorBetter AuthPusherOpenRouterCloudinaryStripe

Client Repo Server Repo Live App

Frontend Setup

Next.js 16 · React 19 · TypeScript · Tailwind CSS 4 · Shadcn UI

Clone & Install

bash

git clone https://github.com/iktushar01/Acadex-client.git
cd Acadex-client
pnpm install
pnpm dev

Requires Node.js 20+. npm install works if you prefer npm over pnpm.

Create .env.local

.env

# Backend API base URL

NEXT_PUBLIC_API_BASE_URL=http://localhost:5000/api/v1

# Frontend origin

NEXT_PUBLIC_BASE_URL=http://localhost:3000

# Must match server ACCESS_TOKEN_SECRET

ACCESS_TOKEN_SECRET=your_access_token_secret

# Real-time classroom chat (optional locally)

NEXT_PUBLIC_PUSHER_KEY=your_pusher_key

NEXT_PUBLIC_PUSHER_CLUSTER=ap2

Run Dev Server

bash

pnpm dev

App running at http://localhost:3000

Backend Setup

Express 5 · Prisma 7 · PostgreSQL (Neon) · Better Auth · Pusher · pgvector

Clone, Install & Generate Prisma Client

bash

git clone https://github.com/iktushar01/Acadex-server.git
cd Acadex-server
pnpm install
pnpm exec prisma generate
pnpm exec prisma db push
pnpm dev

Configure .env— expand each group to copy

Values shown as your_*are placeholders. Pusher and OpenRouter are required for group chat and the study assistant. On Vercel, use Neon's -pooler connection string and deploy both repos to the sin1 region for best latency with ap-southeast-1 databases.

Start the Server

bash

pnpm dev

API available at http://localhost:5000/api/v1

Quick Reference

Local Frontend

http://localhost:3000

Local Backend

http://localhost:5000

API Base

/api/v1

Live Frontend

acadex-client.vercel.app

Live API

acadex-server.vercel.app/api/v1

Key Features

Notes · Chat · AI · Tools

Architecture at a glance

• Auth: Better Auth + JWT in httpOnly cookies on the client domain; browser calls use a token bridge (/api/auth/token) for direct API access.
• Notes: Upload → CR approval → classroom visibility with folders, subjects, comments, and favorites.
• Chat: Membership-gated group messages via REST + Pusher real-time events.
• Study assistant: RAG over indexed note chunks using pgvector embeddings and OpenRouter models.
• Docs: See DOCUMENTATION.md in each repo for full product and API details.

Open Source · MIT License

Build with Acadex

Next.js 16React 19TypeScriptTailwind CSS 4Shadcn UIExpress 5Prisma 7PostgreSQLpgvectorBetter AuthPusherOpenRouterCloudinaryStripe

Client Repo Server Repo Live App

Frontend Setup

Next.js 16 · React 19 · TypeScript · Tailwind CSS 4 · Shadcn UI

Clone & Install

bash

git clone https://github.com/iktushar01/Acadex-client.git
cd Acadex-client
pnpm install
pnpm dev

Requires Node.js 20+. npm install works if you prefer npm over pnpm.

Create .env.local

.env

# Backend API base URL

NEXT_PUBLIC_API_BASE_URL=http://localhost:5000/api/v1

# Frontend origin

NEXT_PUBLIC_BASE_URL=http://localhost:3000

# Must match server ACCESS_TOKEN_SECRET

ACCESS_TOKEN_SECRET=your_access_token_secret

# Real-time classroom chat (optional locally)

NEXT_PUBLIC_PUSHER_KEY=your_pusher_key

NEXT_PUBLIC_PUSHER_CLUSTER=ap2

Run Dev Server

bash

pnpm dev

App running at http://localhost:3000

Backend Setup

Express 5 · Prisma 7 · PostgreSQL (Neon) · Better Auth · Pusher · pgvector

Clone, Install & Generate Prisma Client

bash

git clone https://github.com/iktushar01/Acadex-server.git
cd Acadex-server
pnpm install
pnpm exec prisma generate
pnpm exec prisma db push
pnpm dev

Configure .env— expand each group to copy

Start the Server

bash

pnpm dev

API available at http://localhost:5000/api/v1

Quick Reference

Local Frontend

http://localhost:3000

Local Backend

http://localhost:5000

API Base

/api/v1

Live Frontend

acadex-client.vercel.app

Live API

acadex-server.vercel.app/api/v1

Key Features

Notes · Chat · AI · Tools

Architecture at a glance

• Auth: Better Auth + JWT in httpOnly cookies on the client domain; browser calls use a token bridge (/api/auth/token) for direct API access.
• Notes: Upload → CR approval → classroom visibility with folders, subjects, comments, and favorites.
• Chat: Membership-gated group messages via REST + Pusher real-time events.
• Study assistant: RAG over indexed note chunks using pgvector embeddings and OpenRouter models.
• Docs: See DOCUMENTATION.md in each repo for full product and API details.