Andar Volunteer Connect

The Tournament

Andrésar andar leikar — Andrés Duck Games — is Iceland's longest-running children's alpine ski tournament. Held annually at Skálafell ski resort in Borgarfjörður, the 2026 edition marks the 50th anniversary. Three days of competition, seventeen alpine events, and approximately one hundred volunteers make it one of the largest volunteer-coordinated sporting events in Iceland outside the capital.

Running it requires scheduling roles at every gate and finish area, tracking who is available each day, feeding everyone at the canteen, and keeping a dozen organizers synchronized across a mountain. For years, that coordination happened by phone, spreadsheet, and goodwill.

---

The Registration Flow

Volunteers access the form with a tournament PIN — low-friction verification, not security. From there, a three-tab form (Thursday / Friday / Saturday) collects morning and afternoon shift preferences. Each shift requires a role selection; the available roles are context-aware — Leikjabraut events show different options than standard gate positions. Zod schema validation with Icelandic error messages catches incomplete submissions before they reach the server.

On submit, a single submit_volunteer_registration RPC runs inside a PostgreSQL transaction: create or update the volunteer profile, insert the registration record, run auto-assignment against open event roles, and guard against duplicate entries. If the RPC isn't yet deployed to the environment, the client falls back to legacy direct writes — so migrations never break the live registration form.

The success screen shows a summary card, a WhatsApp QR code for the volunteer group, and a downloadable PDF of the volunteer's assignment.

Admin Dashboard

• Event management — create and edit events, attach roles with capacity limits, view staffing status per shift.
• Volunteer registry — searchable list with inline detail view, manual registration entry for walk-ins, year filter for multi-year history.
• Canteen task board — per-day coordination notes for food preparation and volunteer catering.
• Event reports — daily notes and staffing summaries with a print view for mountain use.
• Bulk email — send tournament communications to all registered volunteers via Resend, authenticated through a Supabase Edge Function so the key never leaves the server.

Public Station Displays

Each competition station has a URL showing live staffing — who is assigned to that position, on which shifts. These pages call get_public_tournament_assignments, a narrow read-only RPC that returns only the fields needed for display. Admin credentials are never required. The pages are designed to load fast on phones in areas with limited mountain connectivity.

Architecture

• Frontend — React 18, TypeScript (strict mode), Vite 8, React Router v6 (HashRouter for static hosting), Tailwind CSS, shadcn/ui, React Hook Form + Zod, TanStack Query, Lucide icons, jsPDF.
• Backend — Supabase PostgreSQL with 9 tables and full Row Level Security. Three server-side functions handle registration, public assignment reads, and phone normalization.
• Code splitting — all 14 admin routes are lazy-loaded via React.lazy(). The volunteer registration bundle stays small for mobile users.
• CI/CD — GitHub Actions runs typecheck, lint, and build on every push. Vercel deploys on merge to main.
• Testing — 83 Playwright end-to-end tests across 7 test files run against the live site. 13 Vitest integration tests cover registration logic and RPC fallback behavior.

Database Schema

Nine tables with cascading relationships and full RLS:

• tournaments → events → event_roles → assignments
• tournaments → volunteer_registrations → profiles
• tournaments → canteen_notes, event_reports, tournament_implementation_notes

A unique constraint on assignments prevents duplicates even under concurrent registration. The normalize_phone function strips formatting before profile lookup, so "+354 5551234" and "5551234" resolve to the same volunteer.