hackathon-nexus

Monorepo with a Vite + React frontend and a FastAPI backend.

Requirements

• Docker + Docker Compose
• Optional: Node.js 20+, Python 3.12 (for running locally without Docker)

Quickstart (Docker)

make up

Backend: http://localhost:8000 Frontend: http://localhost:5173

Database migrations

make migrate

Seed data

make seed

Stop services

make down

View logs

make logs

Local development (optional)

Backend:

cd backend
python -m venv .venv
. .venv/Scripts/activate
pip install -r requirements.txt -r requirements-dev.txt
uvicorn app.main:app --reload

Google OAuth setup

Create backend/.env from backend/.env.example and set:

• GOOGLE_CLIENT_ID
• GOOGLE_CLIENT_SECRET
• GOOGLE_REDIRECT_URI (default: http://localhost:8000/auth/google/callback)

OAuth endpoints:

• GET /auth/google/login returns an authorization URL
• GET /auth/google/callback?code=... completes sign-in/sign-up and returns user payload

Frontend:

cd frontend
npm install
npm run dev

Tests

cd backend
pytest