Get Started

Supa Hub is a community platform monorepo built with Next.js, Supabase, and Once UI.

Updated 9d ago

Supa Hub is a full-featured community platform built as a pnpm monorepo with two apps and nine shared packages. It provides spaces, posts, comments, reactions, follows, notifications, feeds, role-based access control, and a centralized authentication service — all backed by Supabase.

Tech Stack

Framework — Next.js 15 (hub, auth)
UI — Once UI component system
Database — Supabase (PostgreSQL + Auth + Storage)
Rate limiting — Upstash Redis
Monorepo — pnpm workspaces + Turborepo
Deployment — Vercel (two separate projects)
Documentation — This site, hosted on Aveiro

Monorepo Structure

supa-hub/
├── apps/
│   ├── hub/          # Main community app (spaces, posts, feeds)
│   └── auth/         # Centralized auth + admin panel
├── packages/
│   ├── api-handlers/ # Shared API route handlers
│   ├── components/   # Shared React components
│   ├── configs/      # Validation rules & hot-ranking config
│   ├── feed/         # Feed scoring algorithm
│   ├── hooks/        # Shared React hooks
│   ├── providers/    # Auth & user context providers
│   ├── sb/           # Supabase client helpers (server, admin, middleware)
│   ├── types/        # Shared TypeScript types
│   └── utils/        # Shared utilities
└── setup.sql         # Complete database schema

Quick Links

Deployment — Prerequisites, environment variables, and Vercel setup
Architecture — How the apps and packages fit together
Database — Tables, enums, and relationships
API Reference — All API endpoints
Follows — User follow system with notifications
Roles & Permissions — Global and space-level role system
Features — Spaces, posts, comments, notifications, and feeds

Orbit Docs