Suche

Kavel durchsuchen...

Kavel
Dokumentationsmenü

Schnellstart

Erzeuge eine neue App, führe sie lokal aus und sieh in wenigen Minuten, wie API und Web-App miteinander sprechen.

Voraussetzungen

  • Bun 1.3 oder neuer, der Paketmanager und die Runtime
  • Ein Cloudflare-Konto (die kostenlose Stufe reicht zum Start)

1. Deine App erstellen

Führe den Scaffolder aus und wähle bei der Abfrage die gewünschten Module:

bash
bun create kavel@latest my-app

Die CLI klont die Vorlage, setzt nur die gewählten Module zusammen, installiert Abhängigkeiten, legt eine lokale .dev.vars an, generiert Typen und initialisiert ein Git-Repository.

2. Die Dev-Server starten

bash
cd my-app
bun dev

Turbo startet beide Apps parallel: die API auf localhost:8787 und die Web-App auf localhost:3000. Öffne die Web-App und es läuft.

Tipp

Die API stellt in der Entwicklung eine interaktive Referenz unter /rpc/docs bereit. Sie wird automatisch deaktiviert, wenn ENVIRONMENT gleich production ist.

3. Die Datenbank einrichten

Wenn du ein Modul gewählt hast, das die Datenbank nutzt (Auth, E-Mail oder Zahlungen), generiere und wende die lokalen Migrationen an:

bash
cd apps/api
bun db:generate
bun db:migrate

db:generate verwandelt dein Drizzle-Schema in SQL-Migrationen; db:migrate wendet sie auf die lokale D1-Datenbank an. Schreibe Migrationen nie von Hand, ändere das Schema und generiere neu.

4. Secrets nach und nach ergänzen

Module laufen mit sinnvollen No-Ops, bis du Zugangsdaten hinzufügst, du kannst dich registrieren und herumklicken, bevor du irgendetwas konfigurierst. Wenn du so weit bist, öffne apps/api/.dev.vars und trage die Schlüssel für die genutzten Dienste ein. Die vollständige Liste findest du unter Konfiguration.

Nächste Schritte