zazzy
Getting started

First run

Bring up Postgres, apply the schema, and start the dev server.

When generate finishes, it prints a next-steps block tailored to your package manager. This page walks those steps and what each one does. The commands below use pnpm; the generator prints the correct form for whichever manager you chose (for npm, scripts run as npm run <script>).

The printed next steps

Created my-app in my-app

Next steps:
  cd my-app
  docker compose up -d          # start Postgres (and any selected services)
  pnpm prisma migrate dev       # apply the schema
  pnpm dev                      # start the app on http://localhost:3000

The dependency install already ran during generation's verify step, so you don't install again — you go straight to the services and the database.

1. Start the local services

cd my-app
docker compose up -d

The generated docker-compose.yml always includes Postgres. Selected features add their own services — jobs adds Inngest, files adds MinIO — and pruned features' services are stripped from the compose file, so it only runs what your app actually uses.

2. Apply the schema

pnpm prisma migrate dev

This applies the Prisma migrations to the database, creating the tables your selected features need. The .env written at generation time already points DATABASE_URL at the local Postgres (or at the --database-url you passed).

3. Start the dev server

pnpm dev

The app comes up on http://localhost:3000.

Your .env is local and uncommitted

generate writes .env from the pruned .env.example and prefills your --database-url if you gave one. .env is gitignored, so the initial commit never carries your secrets — .env.example is what ships. Fill in any feature-specific keys (Stripe, Resend, etc.) there before using those features.

Where to go next

  • Project tour — find your way around the generated app.
  • The generated app's own README.md lists exactly the features you selected and repeats these setup steps for your package manager.
  • docs/DEPLOY.md in the generated app is a Vercel-first production guide; its feature-specific sections (Stripe, Inngest, Resend, S3, Sentry) are present only for the features you kept.

On this page