◀ All projects
PROJECT MANAGEMENTFULLSTACK May 2025

ClassHub

Collaborative Study Platform for University Students

A real-time collaborative platform where every feature (chat, Q&A, file sharing, and study session scheduling) is scoped per class, built with React and Firebase.

ClassHub: Collaborative Study Platform for University Students

University students juggle class-specific discussions, course material, and study coordination across disconnected tools (group chats, email threads, shared drives) with no single space scoped to this class, this semester.

ClassHub is a real-time platform where every feature (chat, Q&A, file sharing, and study session scheduling) is scoped per class. Students browse and join classes via a live course-catalog integration, then collaborate inside class-specific feeds that update instantly for everyone enrolled.

Main dashboard page
Figure 1: Main dashboard page
Chat page in separate class
Figure 2: Chat page in separate class

Architecture

Data Model
Firestore is structured as classes/{classId}/{chat|qa|sessions|resources}/…, with nested replies and messages subcollections. Every piece of content is namespaced to its class rather than living in flat global collections, so isolating one class’s feed from another is structural, not filtered client-side.
Real-time Sync
All major views (chat, Q&A, session lists, in-session chat) subscribe via Firestore onSnapshot listeners rather than polling, so messages, votes, and replies appear instantly for every connected client. Firestore is configured with persistentLocalCache + multi-tab manager for offline support and fast reloads in production, with a long-polling fallback in local dev to work around a WebChannel/React 19 StrictMode double-invocation issue.
Security Rules
Firestore and Storage rules enforce access control server-side: authenticated reads, ownership checks on writes/deletes (authorId == request.auth.uid), and a default-deny fallback rule, with a 20 MB upload cap on Storage.
Auth
Passwordless email-link sign-in restricted to university email addresses, avoiding password management entirely.
External Data Integration
Course catalog data is pulled from a third-party academic data API (Paper.nu) through a Cloud Functions proxy (to dodge CORS and add caching headers), normalized client-side, and cached in localStorage with a schema-version key so stale shapes self-invalidate on the next fetch.
Local Dev Workflow
Full Firebase Emulator Suite (Firestore, Auth, Storage) wired into the app via hostname detection, so the team could develop and test against realistic backend behavior without touching production data.

Design System

Token system: Built a custom design token system in Tailwind config rather than using default colors: a defined brand purple scale (brand, brand-hover, brand-light), semantic text/background/border tokens (primary, sub, muted, line, subtle), and purpose-specific border radii (badge, btn, card, modal, avatar) so spacing and rounding stayed consistent across cards, modals, and chips.

Component patterns: Reusable Tag/Avatar/badge primitives with a fixed semantic color palette (purple/teal/green/orange/pink/blue) deterministically assigned per user, so the same person’s avatar color stays consistent across chat, Q&A, and session rosters.

Layout: Persistent sidebar (class list, navigation) + header + main content + contextual right sidebar, with modal-based flows (course discovery, create-session) layered on top via React Router’s background-location pattern.

My Role

As Project Manager, I led a team of student engineers through the full build, from defining the product scope and feature set to setting the technical architecture and reviewing the team’s work into production.

I also worked hands-on in the codebase, building out the core Firebase layer: the per-class Firestore data model, passwordless email-link authentication, real-time chat/Q&A/study-session features, security rules for access control, and the deployment pipeline (Emulator Suite for local dev, Hosting + Cloud Functions for production).

We presented in 4 rounds in front of industry representatives at the IEEE Technical Program final showcase.

Stack

Frontend
React 19 · React Router · Tailwind CSS · Vite
Backend & Infrastructure
Firebase Firestore · Auth · Storage · Cloud Functions · Hosting
External APIs
Paper.nu course catalog API
Context
IEEE Technical Program · Project Manager

End of file

You made it to the end! Coin already collected

+1 coin · +25 XP. Thanks for reading this far. You’ve read this one before. Thanks for coming back.