README

Docs  |  Discord  |  X  |  Blog Post  |  Architecture



  
  
  


---

 Using Prisma 7? It is maintained for eighteen months after 8.0.0 final; supported versions says what that covers. Its source lives on the v7 branch of this repository and its docs at prisma.io/docs/orm/v7.

 Prisma 8 is a release candidate. 8.0.0 final is expected in the next four to eight weeks. Until then a release candidate may include breaking changes, and every release ships with an upgrade recipe that the prisma-8 skill applies for you. The candidate is a complete implementation we stand behind: we treat bugs in it as urgent, and the risk you take on is a feature that is not built yet rather than churn. The feature scoreboard names every gap. New projects should start here. Existing Prisma 7 applications can migrate incrementally, and Prisma 7 stays maintained on the v7 branch for eighteen months after 8.0.0 final. Star the repo, follow @prisma on X, or read along on the Prisma blog.

Prisma 8 is a TypeScript rewrite of Prisma ORM, designed to be extensible, composable, and AI-agent friendly by default. Read the announcement or start with the docs.

 Prerequisites

- Node.js 24 or newer
- A package manager (npm, pnpm, or yarn)

 Getting started

 1. Scaffold a new project

The interactive scaffolder picks an app template (Next.js, Hono, Nuxt, Astro, NestJS, SvelteKit, TanStack Start, or Elysia) and wires Prisma 8 in with your chosen database (PostgreSQL or MongoDB):

bash
npm create prisma


You finish with a runnable app, a starter contract, and the agent skills already installed. See the create-prisma reference for every template and flag, or follow the PostgreSQL and MongoDB quickstarts.

 2. Or, add Prisma 8 to an existing project

Run this from your repo root:

bash
npx prisma orm init


orm init writes prisma.config.ts, scaffolds a starter contract and db.ts under src/prisma/, installs the runtime, and emits the contract. It does not touch your framework or build setup. Then install the agent skills:

bash
npx prisma skills sync


See the orm init and skills CLI references, or the guides for adding Prisma 8 to an existing PostgreSQL or MongoDB app.

 3. Use your AI agent for everything Prisma 8

Both installers leave a top-level prisma-8.md primer at your project root for any agent to read first, and install one SKILL.md per workflow into the directories agent runtimes read:

- .claude/skills//SKILL.md — Claude Code
- .cursor/skills//SKILL.md — Cursor
- .agents/skills//SKILL.md — universal location for Copilot Agent and other runtimes
- .devin/skills//SKILL.md — Devin

Skills ship inside the Prisma packages your project installs, so they always describe the version in use. Your editor's AI assistant auto-loads the right skill when your prompt matches.

Just describe what you want. For example:

 "Add a posts model with a relation to users, then write a query that loads each user's three most recent posts."

The agent loads the prisma-8 skill, opens its contract