OAn
OAn ist ein schlankes QR-Code-Foto-Sharing-Grundgerüst für Hochzeiten und Events. Gäste öffnen den QR-Link ohne App und Account, teilen Fotos oder Nachrichten und sehen neue Inhalte auf einer Live-Wall.
Voraussetzungen
- Node.js 22 oder neuer
pnpm 10 oder neuer- Docker Desktop für die lokale Supabase CLI
Lokales Setup
- Abhängigkeiten installieren:
pnpm install
- Supabase CLI installieren und starten:
supabase start
.env.example nach .env.local kopieren und die lokalen Werte aus supabase status eintragen.- Migration und Demo-Event anwenden:
supabase db reset
- Entwicklungsserver starten:
pnpm dev
http://localhost:3000/e/demo oder http://localhost:3000/e/demo/wall öffnen.
Für den Magic-Link-Login muss in Supabase unter Authentication ein Mail-Provider aktiviert sein. Der Service-Role-Key gehört ausschließlich in .env.local und niemals in Client-Code.
Mit Freunden teilen
Für eine öffentliche Testinstanz eignet sich Vercel:
- Repository zu GitHub pushen und in Vercel importieren.
- In Vercel die vier Variablen aus
.env.example setzen. NEXT_PUBLIC_APP_URL muss die echte Vercel-URL ohne abschließenden Slash sein.
- In Supabase unter Authentication → URL Configuration die Vercel-URL als Site URL und
${NEXT_PUBLIC_APP_URL}/auth/confirm als Redirect URL eintragen.
- Unter Authentication einen E-Mail-Provider aktivieren.
- Die Migrationen mit
supabase db push auf das Produktionsprojekt anwenden und den Demo-Seed nur in einer Testdatenbank ausführen.
- Nach dem Deployment einen Event-Link wie
https://deine-domain/e/<slug> teilen.
Der Service-Role-Key darf nur als serverseitige Vercel-Variable hinterlegt werden. Er darf nicht mit NEXT_PUBLIC_ beginnen und nicht in Client-Komponenten importiert werden.
Free-Events erlauben 10 Fotos und laufen nach 14 Tagen ab. Paid-Events sind für 12 Monate aktiv und haben keine Fotoanzahlgrenze. Der Gastgeber kann Originalfotos und Nachrichten jederzeit als ZIP exportieren.
Projektstruktur
app/[locale]: Gastgeberseiten mit /de und /trapp/e/[slug]: sprachneutrale Gästeseiten und Live-Wallapp/api: Upload-, Nachrichten- und Moderations-Route-Handlercomponents: Gast- und Gastgeber-UIlib/supabase: Browser-, Server- und Service-Role-Clientsmessages: deutsche und türkische Übersetzungensupabase/migrations: Schema, RLS, Storage-Bucket und Realtime
Befehle
pnpm dev
pnpm lint
pnpm build
pnpm format
Bewusste Produktgrenzen dieses MVP
- Resumable Uploads mit TUS (TODO im Upload-Code)
- Stripe-Einmalzahlung, Google-Photos-OAuth, pg_cron-Löschung und druckbare QR-Tischkarten als PDF
- Der einfache Rate-Limiter ist pro Serverprozess; für mehrere Instanzen sollte er durch Upstash/Redis oder eine Datenbankfunktion ersetzt werden.
