Zoeken

Zoek in Kavel...

Kavel
Documentatiemenu

Snelstart

Genereer een nieuwe app, draai hem lokaal en zie de API en webapp binnen een paar minuten met elkaar praten.

Vereisten

  • Bun 1.3 of nieuwer, de packagemanager en runtime
  • Een Cloudflare-account (de gratis laag is genoeg om te beginnen)

1. Je app aanmaken

Draai de scaffolder en kies de gewenste modules wanneer daarom wordt gevraagd:

bash
bun create kavel@latest my-app

De CLI kloont de template, assembleert alleen de gekozen modules, installeert dependencies, zet een lokale .dev.vars klaar, genereert types en initialiseert een git-repository.

2. Start de dev-servers

bash
cd my-app
bun dev

Turbo start beide apps parallel: de API op localhost:8787 en de webapp op localhost:3000. Open de webapp en je draait.

Tip

De API biedt in development een interactieve referentie op /rpc/docs. Die wordt automatisch uitgeschakeld wanneer ENVIRONMENT gelijk is aan production.

3. De database opzetten

Als je een module koos die de database gebruikt (auth, e-mail of betalingen), genereer en pas dan de lokale migraties toe:

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

db:generate zet je Drizzle-schema om in SQL-migraties; db:migrate past ze toe op de lokale D1-database. Schrijf migraties nooit met de hand, pas het schema aan en genereer opnieuw.

4. Vul secrets aan onderweg

Modules draaien met verstandige no-ops totdat je credentials toevoegt, je kunt je aanmelden en rondklikken voordat je iets configureert. Als je zover bent, open je apps/api/.dev.vars en vul je de sleutels in voor de diensten die je gebruikt. Zie Configuratie voor de volledige lijst.

Volgende stappen