Club Solution: Student Organization OS

A unified SaaS platform for managing student clubs, governance, finance, and events.

Tech Stack

• Monorepo: Turborepo
• Backend: NestJS
• Frontend: Next.js (App Router) + Tailwind CSS
• Mobile: React Native (Expo)
• Database: PostgreSQL + Prisma
• Infra: Docker Compose (Postgres, MinIO, Keycloak)

Getting Started

1. Install Dependencies

npm install

2. Start Infrastructure

Start the database, S3 storage, and Auth service:

docker-compose up -d

3. Setup Database

Apply the Prisma schema to the database:

cd packages/database
npx prisma db push

4. Run Development Server

Start all apps (API, Web, Mobile) in parallel:

npm run dev
# OR with Turbo
turbo run dev

Structure

• apps/api: NestJS Backend (Port 3001)
• apps/web: Next.js Dashboard (Port 3000)
• apps/mobile: Expo React Native App
• packages/database: Shared Prisma Client and Schema

Environment Variables

Copy .env.example (if available) to .env in each app. Default Docker credentials:

• Postgres: admin / password
• MinIO: admin / password
• Keycloak: admin / admin