Get started with Prisma

Prisma is a complete TypeScript stack with one workflow: build your app and run all of it on your machine, then deploy it to the Prisma platform with one command. Jump straight to the full-stack tutorial, Prisma 8 or Prisma 7 docs.

Build

Define the app in TypeScript and run everything locally before you ship.

Local development

One command runs your whole app on your machine: your services on Bun, wired to local Postgres and local storage. No cloud credentials.

ComposerEarly Access

Declare your services and the resources they depend on: databases, jobs, buckets, secrets.

ORM

Model your data and query it with type safety, end to end.

Deploy

One deploy provisions everything on the Prisma platform and connects it.

Compute

Hosting for your services, next to your data.

Storage

S3-compatible object storage inside your project.

Postgres

Managed PostgreSQL, provisioned during setup.

Deploy

Ship from a git push, the Console, or Composer. Every branch gets its own environment.

Pick your framework

Every guide runs the same journey with the same commands: scaffold, connect Prisma Postgres, run a real query, and deploy. SvelteKit and Deno don't deploy to Compute yet; their guides stop at a verified local run.

Next.js Hono TanStack Start NestJS Astro Nuxt SvelteKit Bun Elysia Deno

If you're using Express or another Node.js server, follow the existing-project path instead.

Using Prisma 7?

Prisma 7 is the current generally available release of Prisma ORM and remains fully supported. Scaffold it with npx create-prisma@stable, or add it to an existing project with npx prisma@latest init. It pairs with Prisma Postgres and Prisma Compute the same way. When you're ready, Prisma 8 is the upgrade path.

Prisma 7 setup pathsAll database quickstarts, plus the agent prompt Prisma 7 quickstart5 minWith Prisma Postgres

Other setups

Already have an app or a database, or need a single Prisma product on its own? Each path has a guide to follow and a prompt to hand to your agent.

Existing project, your own database, or a single product on its ownFive paths: add to an existing project, bring your own Postgres, or use the ORM, Postgres, or Compute alone.

Other setup paths

Add Prisma to an existing projectPostgreSQL guide

Add Prisma to an existing project

Add Prisma 8 to this existing project.

This flow is for PostgreSQL. If the project uses MongoDB, follow https://www.prisma.io/docs/v8/add-to-existing-project/mongodb.md instead; for other databases, stop and tell me.

1. Run `npx prisma@next orm init`. It writes `prisma.config.ts`, a starter contract and `db.ts` under `src/prisma/`, and installs Prisma 8 skills for you.
2. Set `DATABASE_URL` in `.env` to my database. If I did not give you one, create a Prisma Postgres database with `npx create-db@latest`, put its connection string in `.env`, and show me the claim URL it prints so I can keep the database.
3. If the database already has tables, infer the contract from it: `npx prisma@next contract infer`, then `npx prisma@next contract emit`, then sign it with `npx prisma@next db sign`. If the database is empty, keep the starter contract and run `npx prisma@next db init`.
4. Write one query with the generated `db` client in an existing code path, run it, and show me the returned rows.

Follow https://www.prisma.io/docs/v8/add-to-existing-project/postgresql.md and the installed Prisma 8 skills.

Prisma 8 with your own PostgreSQL databaseQuickstart

Prisma 8 with your own PostgreSQL database

Create a new [framework] application with Prisma 8 against my existing PostgreSQL database.

If I have not given you a connection string, stop and ask; do not invent one. Valid --template values: next, hono, nuxt, astro, nest, svelte, tanstack-start, elysia.

1. Scaffold: `npx create-prisma@latest create my-app --template [framework] --provider postgres --yes`.
2. Export my connection string as `DATABASE_URL` in the shell; the generated scripts read the environment variable, not `.env`. From the project directory: `npm run db:init`, then start `npm run dev` in the background and verify the sample query returns data. Sample users are seeded automatically on the app's first query; there is no separate seed script.
3. Evolve the starter contract under `src/prisma/` into my schema, then run `npm run contract:emit`, `npx prisma@next migration plan`, and `npx prisma@next migrate --yes`.

Do not provision any hosted database. Use the installed Prisma 8 skills and https://www.prisma.io/docs/llms.txt for current docs.

Prisma ORM only (Prisma 7)Quickstart

Prisma ORM only (Prisma 7)

Add Prisma ORM 7 to this project with my existing database.

If I have not given you a database connection string and none exists in the project, stop and ask.

1. Run `npx prisma@latest init` (Prisma 7). For an existing database, set DATABASE_URL in `.env` and introspect it with `npx prisma db pull`; for a new schema, define models in `prisma/schema.prisma` and run `npx prisma migrate dev --name init`. If migrate dev asks to reset the database, stop and ask me first.
2. Install the driver adapter for the database (Prisma 7 requires one), e.g. `npm install @prisma/adapter-pg` for PostgreSQL, and pass it to `new PrismaClient({ adapter })`. Generate the client with `npx prisma generate` and write one query in an existing code path.
3. Run the query (e.g. with `npx tsx`) and show me the output, the schema, and the query you added.

Current docs: https://www.prisma.io/docs/orm.md and https://www.prisma.io/docs/llms.txt.

Prisma Postgres onlycreate-db guide

Prisma Postgres only

Create a Prisma Postgres database for this project.

1. Run `npx create-db@latest`. It creates a temporary Prisma Postgres database without an account and prints a connection string plus a claim URL.
2. Put the connection string in `.env` as DATABASE_URL and wire it into whichever of Prisma ORM, Kysely, Drizzle, TypeORM, or node-postgres the project already uses (detect it from package.json; if none, ask me). Verify the connection with one trivial query such as `select 1`.
3. Remind me to open the claim URL to keep the database in my Prisma workspace.

Current docs: https://www.prisma.io/docs/postgres.md.

Prisma Compute onlyDeploy guide

Prisma Compute only

Deploy this app to Prisma Compute using `npx @prisma/cli@latest`.

Compute supports Next.js (with `output: "standalone"` in its config), Nuxt, Astro, Hono, NestJS, TanStack Start, and plain Bun servers; for a Bun or Elysia server pass `--framework bun --entry <server file>`. If the app is none of these, stop and tell me.

1. Confirm I am signed in with `npx @prisma/cli@latest auth whoami`; if not, stop and ask me to run `npx @prisma/cli@latest auth login`.
2. Run `npx @prisma/cli@latest app deploy` from the project directory. If the app reads env vars from `.env` (like DATABASE_URL), add `--env .env`. If deploy fails with `PROJECT_SETUP_REQUIRED` (the directory is not pinned to a project yet), rerun with `--create-project <app-name>`, or `--project <id>` for an existing project. Add `--db` only if it needs a brand-new database; Compute then provisions Prisma Postgres and wires the connection string.
3. Fetch the deployed URL with curl and confirm the app responds. If it does not, read `npx @prisma/cli@latest app logs` briefly (it streams; stop it after reading).

Current docs: https://www.prisma.io/docs/prisma-compute/deploy.md.

If you're using MongoDB, follow the MongoDB quickstart or add Prisma 8 to an existing MongoDB app. If you work with Kysely, Drizzle, or TypeORM, follow the Prisma Postgres quickstart for that tool.

Browse the docs

This page hides the full navigation to keep the first run focused. Everything is one click away.

Prisma ORMPrisma 7 and Prisma 8 Prisma PostgresThe managed database Prisma ComputeHosting and branching CLI referenceEvery command and flag GuidesFrameworks and workflows AI toolsSkills, MCP, and prompts