prisma/orm

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):

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:

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:

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-name>/SKILL.md — Claude Code
• .cursor/skills/<skill-name>/SKILL.md — Cursor
• .agents/skills/<skill-name>/SKILL.md — universal location for Copilot Agent and other runtimes
• .devin/skills/<skill-name>/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 and queries references, then drives the change end-to-end.

For the full catalogue and what each skill covers, see skills/README.md.

Found a bug, missing a feature, or have a question for the team?

Ask your agent. The prisma-8 skill's feedback flow drafts a structured GitHub issue or hands you a Prisma Discord link for live Q&A. You can review and confirm before anything is submitted.

For extension authors

Prisma 8 has a minimal core. Everything around it, including Postgres support itself, is built on the same public SPI that's available to any author. If you've wanted to integrate your tool, your database, or your library with Prisma, this is the way in.

Extensions already shipping:

• @prisma/orm-extension-pgvector: vector columns and similarity search.
• @prisma/orm-extension-postgis: geometry columns and geo queries.
• @prisma/orm-extension-paradedb: BM25 full-text search indexes (experimental).
• @prisma/orm-extension-supabase: Supabase auth and storage tables, role-bound clients (experimental).
• @prisma/orm-extension-arktype-json: JSON columns validated by an arktype schema.
• @prisma/orm-postgres-contrib: packs for the trusted PostgreSQL contrib modules, starting with citext case-insensitive text.
• @cipherstash/prisma-next: searchable encryption and data-level access control.

See Using extensions for how to install and register one. Want to ship your own? The call for extension authors walks through the SPI, the layers your extension can hook into, and how the team features new extensions.

Supported databases

• PostgreSQL — the primary target, first-class support
• MongoDB — first-class support
• SQLite — planned next, a proof of concept today

MySQL follows after SQLite. See the feature scoreboard for what each database supports today.

Contributing

See CONTRIBUTING.md for setup, commands, DCO signoff, and PR expectations. For substantive changes, please open an issue first so we can give direction-fit feedback before you invest implementation time. The vision says where Prisma 8 is going, and the steering list names requests we have already answered, with what to use instead.

Security issues: follow the Private Vulnerability Reporting flow in SECURITY.md. Please do not file them as public issues.

Community

Built something with Prisma 8? Tag @prisma on X. The best community builds get a shout-out and a link here.

• Discord: Talk to us in Discord
• X: @prisma
• Blog: prisma.io/blog

License

Apache 2.0. See LICENSE.