UWDSC Website v3 - Documentation

Welcome to the UW Data Science Club monorepo documentation! This comprehensive guide will help you understand our codebase architecture, setup process, and development workflow.

🚀 What is this project?

This is a modern, full-stack monorepo that powers the UW Data Science Club’s digital presence, including:

  • Main Website (apps/web) - The primary UWDSC website and member applications
  • Admin App (apps/admin) - Admin dashboard and CXC (AI hackathon) application/review system
  • Shared UI Package (packages/ui) - Design system with shadcn/ui components
  • Backend (packages/server) - @uwdsc/db, @uwdsc/core, @uwdsc/admin for data, shared logic, and admin services

🎯 Quick Links

🚀 Getting Started

Set up your development environment and run the apps

View Guide →

🏗️ Architecture

Learn about our monorepo structure and design patterns

View Architecture →

📚 Guides

Step-by-step tutorials for common development tasks

View Guides →

📦 Packages

Detailed documentation for each package in the monorepo

View Packages →

📝 Timeline

Track features and updates organized by semester

View Timeline →

🛠️ Tech Stack

Our monorepo is built with modern technologies:

  • Frontend: Next.js 16 (web, admin), React 19, TypeScript
  • Styling: Tailwind CSS, shadcn/ui
  • Backend: Supabase, postgres.js (via @uwdsc/db), db-migrate, PostgreSQL
  • Monorepo: Turborepo, pnpm workspaces
  • Validation: Zod
  • Animation: Framer Motion

📖 Documentation Structure

  • Getting Started - Installation, setup, and first steps
  • Architecture - System design, data flow, and patterns
  • Guides - Practical tutorials for common tasks
  • Packages - In-depth package documentation
  • Contributing - Guidelines for contributors

🤝 Contributing

We welcome contributions! Check out our Contributing Guide to get started.

📝 License

This project is licensed under the MIT License.

Getting Started