Prisma 8
Create a Prisma 8 app with Prisma Postgres.
Create a Prisma 8 app backed by Prisma Postgres.
Quick start
bunx create-prisma@latestRun this from a Node.js 24 or newer environment. When prompted, choose PostgreSQL.
Setup adds a starter contract, creates prisma-next.md, installs project-level Prisma 8 skills for your coding agent, and adds package scripts for the database steps below. Choose the minimal template if you want the fastest first run, or a framework template when you want the first query wired into an app route or page.
1. Create the database
Create a Prisma Postgres database from the terminal and export its connection string. The generated scripts read the environment variable, not .env:
bunx create-db@latestexport DATABASE_URL="<the connection string create-db printed>"The command also prints a claim URL; open it within 24 hours to keep the database in your account.
2. Initialize the database
From the generated project directory, run db:init to apply the starter schema to Prisma Postgres and sign the database.
bun run db:initSample users are seeded automatically the first time the app queries the database, so there is no separate seed step.
3. Run the app
Start the app and confirm the sample query runs successfully.
bun run devUse the URL or terminal output shown by your template to confirm the sample query runs successfully.
Next steps
- Open the generated contract and change the starter model.
- Use Import from PostgreSQL or Import from MySQL when you want to move an existing database to Prisma Postgres.
- Use the PostgreSQL existing-project guide when your app already has a Prisma Postgres database.
