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
- Rufen Sie http://localhost:3000/auth/sign-up auf
- Geben Sie Ihre E-Mail-Adresse und Ihr Passwort ein
- Prüfen Sie unter http://localhost:54324 die Bestätigungs-E-Mail
- Klicken Sie auf den Bestätigungslink
- Sie können loslegen!
Nächste Schritte
Jetzt, da Ihre App läuft:
- Dashboard erkunden – Sehen Sie sich die wichtigsten Funktionen an
- Code durchsehen – Machen Sie sich mit der Struktur vertraut
- Dokumentation lesen – Lernen Sie die zentralen Konzepte kennen
- 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?
- Erfahren Sie mehr über die Projektstruktur
- Lernen Sie die Konfigurationsoptionen kennen
- Befolgen Sie die Best Practices