ossrules.md

prisma-8

Use when working in a project that depends on @prisma/orm-postgres, @prisma/orm-sqlite, or @prisma/orm-mongo (Prisma 8, formerly Prisma Next): editing contract.prisma or a contract.ts builder, running `prisma contract emit`, planning or applying migrations, editing migration.ts, writing db.orm / db.sql / db.query queries, wiring db.ts or middleware, integrating a build tool, using the Supabase extension or RLS, or reading a dotted error code such as MIGRATION.HASH_MISMATCH. Use when the user asks "what is Prisma 8", "where do I start", or compares it to another ORM. Use when the user asks to upgrade or bump Prisma 8 in an app or an extension package. Use when you see @internal/* or @prisma/orm-* imports, prisma.config.ts with definePrismaConfig, or contract.json / contract.d.ts. Do not use for Prisma ORM 7 or earlier (schema.prisma + @prisma/client).

Install
npx skills add 'https://github.com/prisma/orm/tree/main/skills/prisma-8'
Download bundle ↓
main · fac8604 ↗Scanned 2026-09-17

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗

upgrading/app/upgrades/8.0.0-rc.6-to-8.0.0-rc.7/instructions.md

upgrading/app/upgrades/8.0.0-rc.6-to-8.0.0-rc.7/instructions.mdBrowse 76 files
View on GitHub
460 tokens

1,794 bytes
Token encoding: o200k_base
Snapshot fac8604

← Back to SKILL.md

from: "8.0.0-rc.6" to: "8.0.0-rc.7" changes:

  • id: rename-orm-pagination-methods summary: | Rename ORM collection pagination calls from .take(n) to .limit(n) and from .skip(n) to .offset(n). This applies to SQL and Mongo ORM collections, including relation refinements and grouped SQL collections. Do not rename Mongo query-builder .skip(n) calls: that lower-level API continues to mirror the $skip pipeline stage.
  • id: contract-artifacts-restamp summary: | The emitted contract.json / contract.d.ts embed the toolchain version, which moves to 8.0.0-rc.7. Run contract emit once after upgrading so the emitted artifacts match the installed toolchain. The toolchain also re-released against @prisma/cli-engine@0.2.3 (a CLI-side change with no ORM-facing surface). detection: glob: "**/contract.json" contains: - '"version": "8.0.0-rc.6"'

8.0.0-rc.6 → 8.0.0-rc.7 — User upgrade instructions

rename-orm-pagination-methods

Find calls on Prisma 8 ORM collections and apply these translations:

  • .take(n) → .limit(n)
  • .skip(n) → .offset(n)

Apply the same translation inside include(...) refinement callbacks, combine(...) branches, and after SQL ORM groupBy(...). Leave Mongo query-builder chains that start from db.query.from(...) unchanged: their .limit(...) and .skip(...) methods name Mongo aggregation pipeline stages rather than the ORM collection API.

contract-artifacts-restamp

For every contract.json matched by detection, run the project's emit command (prisma contract emit, or the project's contract:emit script) once after upgrading. The only expected diff beyond the pagination rename is the embedded version moving to 8.0.0-rc.7.

← All Prisma ORM skillsProject instructions →