How joannacodes/giftroll works
GiftRoll is an accountless gift-exchange website. Hosts create an exchange and share its invite link and creator code; participants join by invite, then receive private reveal links. A creator verifies access, closes sign-ups by drawing assignments, and participants use their reveal links to see recipients. The controller excerpt shows database reads/writes and view selection; the README identifies hosted Supabase Postgres. The graph preserves the documented capabilities, but does not infer unsampled integration details.
Main entry points: web.php Web Routes · giftroll Exchange Pages · ExchangeController.php Create Exchange · index.php Laravel Front Controller
Components 13
Web Entry
- Laravel Front Controller
public/index.php - Application Bootstrap
bootstrap/app.php - Web Routes
routes/web.php
Exchange Workflow
- Create Exchange
app/Http/Controllers/ExchangeController.php - Join Exchange
app/Http/Controllers/ExchangeController.php - Creator Access
app/Http/Controllers/ExchangeController.php - Assignment Draw
app/Http/Controllers/ExchangeController.php - Recipient Reveal
app/Http/Controllers/ExchangeController.php - Exchange Pages
resources/views/giftroll
Persistence
- Supabase Postgres
- Exchange Schema
database/migrations/2026_11_21_000003_create_giftroll_exchanges.php
Other components
- Host
- Participant
Connections 20
- Laravel Front Controller → Application Bootstrap: loads app
public/index.php - Application Bootstrap → Web Routes: registers routes
bootstrap/app.php - Host → Laravel Front Controller: sends requests
- Participant → Laravel Front Controller: sends requests
- Web Routes → Create Exchange: dispatches
routes/web.php - Web Routes → Join Exchange: dispatches
routes/web.php - Web Routes → Creator Access: dispatches
routes/web.php - Web Routes → Assignment Draw: dispatches
routes/web.php - Web Routes → Recipient Reveal: dispatches
routes/web.php - Create Exchange → Supabase Postgres: writes exchange
app/Http/Controllers/ExchangeController.php - Join Exchange → Supabase Postgres: reads and writes
app/Http/Controllers/ExchangeController.php - Creator Access → Supabase Postgres: reads exchange
app/Http/Controllers/ExchangeController.php - Assignment Draw → Supabase Postgres: assigns recipients
app/Http/Controllers/ExchangeController.php - Recipient Reveal → Supabase Postgres: reads assignment
app/Http/Controllers/ExchangeController.php - Create Exchange → Exchange Pages: renders pages
app/Http/Controllers/ExchangeController.php - Join Exchange → Exchange Pages: renders pages
app/Http/Controllers/ExchangeController.php - Creator Access → Exchange Pages: renders pages
app/Http/Controllers/ExchangeController.php - Assignment Draw → Exchange Pages: renders manager
app/Http/Controllers/ExchangeController.php - Recipient Reveal → Exchange Pages: renders reveal
app/Http/Controllers/ExchangeController.php - Exchange Schema → Supabase Postgres: defines tables