Raccoon Open

Tournament management web app for community Umamusume Pretty Derby tournaments.

Handles the full tournament lifecycle — player registration, team drafts, race scoring, analytics, and Discord-ready result exports.

Features

• Two tournament formats — Blind Pick and Draft Pick, each with their own phase progression (registration → draft → ban → pick → active → completed)
• Player drafts — Snake draft order for teams, uma ban/pick phases with slot animation
• Live race scoring — Automatic point calculation from race placements, group stage + finals
• Analytics — Per-player stats, Hall of Fame categories, season breakdowns, opponent records
• Player profiles — Discord-linked accounts with uma rosters, support cards, and match history
• Discord integration — One-click export of results formatted for Discord markdown
• Real-time sync — Firestore onSnapshot keeps all clients in sync during live events

Tech Stack

Layer	Technology
Frontend	Vue 3 (Composition API), TypeScript, Tailwind CSS v4, PrimeVue
Backend	Firebase Cloud Functions (TypeScript)
Database	Firestore
Auth	Firebase Auth with Discord OIDC
Hosting	Firebase Hosting
CI/CD	GitHub Actions (deploy on push to main)

Getting Started

Prerequisites

• Node.js v18+
• Firebase CLI — npm install -g firebase-tools
• Java (required for Firebase Emulators)

Setup

1. Clone the repo and install dependencies:

   git clone https://github.com/jacobfreise/raggooner-open.git
   cd raggooner-open
   cd frontend && npm install
   cd ../functions && npm install

2. Create frontend/.env with your Firebase config:

   VITE_FIREBASE_API_KEY=
   VITE_FIREBASE_AUTH_DOMAIN=
   VITE_FIREBASE_PROJECT_ID=
   VITE_FIREBASE_STORAGE_BUCKET=
   VITE_FIREBASE_MESSAGING_SENDER_ID=
   VITE_FIREBASE_APP_ID=
   

3. Start the emulators and dev server:

   firebase emulators:start        # Firestore on :8080, Auth on :9099
   cd frontend && npm run dev      # App on :5173

Contributing

1. Fork and clone the repo
2. Create a branch (git checkout -b feature/your-feature)
3. Make changes and verify (cd frontend && npm test && npm run build)
4. Open a pull request against main

License

MIT — see LICENSE.