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:3000The 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 -dThe 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 devThis 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 devThe 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.mdlists exactly the features you selected and repeats these setup steps for your package manager. docs/DEPLOY.mdin 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.