Schnellstart

Bringen Sie Ihre Anwendung mit dieser Schnellstartanleitung in wenigen Minuten zum Laufen.

Hinweis: Dies sind Beispiel- bzw. Platzhalterinhalte zu Demonstrationszwecken.

Richten Sie Ihre Entwicklungsumgebung schnell ein und bringen Sie sie zum Laufen.

Voraussetzungen

Stellen Sie vor dem Start sicher, dass Folgendes vorhanden ist:

  • Node.js 18.x oder höher
  • pnpm 8.x oder höher
  • Git zur Versionskontrolle
  • Ein Supabase-Konto (die kostenlose Stufe funktioniert hervorragend)

Schritt 1: Repository klonen

git clone https://github.com/yourorg/yourapp.git
cd yourapp

Schritt 2: Abhängigkeiten installieren

pnpm install

Dadurch werden alle erforderlichen Abhängigkeiten im gesamten Monorepo installiert.

Schritt 3: Umgebungsvariablen einrichten

Kopieren Sie die Beispiel-Umgebungsdatei:

cp apps/web/.env.example apps/web/.env.local

Passen Sie die folgenden Variablen an:

# Supabase-Konfiguration
NEXT_PUBLIC_SUPABASE_URL=http://localhost:54321
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key-here
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key-here

# Anwendung
NEXT_PUBLIC_SITE_URL=http://localhost:3000

Schritt 4: Supabase starten

Starten Sie Ihre lokale Supabase-Instanz:

pnpm supabase:web:start

Dieser Befehl:

  • startet die PostgreSQL-Datenbank
  • startet Supabase Studio (localhost:54323)
  • wendet alle Migrationen an
  • befüllt die Datenbank mit Ausgangsdaten

Schritt 5: Entwicklungsserver starten

pnpm dev

Ihre Anwendung ist anschließend unter folgenden Adressen erreichbar:

  • App: http://localhost:3000
  • Supabase Studio: http://localhost:54323
  • E-Mail-Tests: http://localhost:54324

Schritt 6: Ersten Benutzer anlegen

  1. Rufen Sie http://localhost:3000/auth/sign-up auf
  2. Geben Sie Ihre E-Mail-Adresse und Ihr Passwort ein
  3. Prüfen Sie unter http://localhost:54324 die Bestätigungs-E-Mail
  4. Klicken Sie auf den Bestätigungslink
  5. Sie können loslegen!

Nächste Schritte

Jetzt, da Ihre App läuft:

  1. Dashboard erkunden – Sehen Sie sich die wichtigsten Funktionen an
  2. Code durchsehen – Machen Sie sich mit der Struktur vertraut
  3. Dokumentation lesen – Lernen Sie die zentralen Konzepte kennen
  4. Eigene Funktion entwickeln – Beginnen Sie mit der Anpassung

Häufige Probleme

Port bereits belegt

Wenn Port 3000 bereits belegt ist:

# Prozess finden und beenden
lsof -i :3000
kill -9 <PID>

Supabase startet nicht

Versuchen Sie, Supabase zurückzusetzen:

pnpm supabase:web:stop
docker system prune -a  # Docker bereinigen
pnpm supabase:web:start

Fehler bei der Datenbankverbindung

Stellen Sie sicher, dass Docker läuft, und starten Sie Supabase neu:

docker ps  # Prüfen, ob Docker läuft
pnpm supabase:web:reset

Wie geht es weiter?