prisma-mongodb-upgrade

Guides Prisma v6 MongoDB projects through migration decisions to Prisma Next.

1|2|Updated Aug 14, 2026
One-click install
npx skills add https://github.com/byEduarda/TrabalhoFinal-EJCM2026.2 --skill prisma-mongodb-upgrade-byeduarda
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prisma-mongodb-upgrade
Source: https://github.com/byEduarda/TrabalhoFinal-EJCM2026.2/tree/main/back/src/.windsurf/skills/prisma-mongodb-upgrade
Command: npx skills add https://github.com/byEduarda/TrabalhoFinal-EJCM2026.2 --skill prisma-mongodb-upgrade-byeduarda

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? MongoDB projects on Prisma v6 have no upgrade path to Prisma 7, which ships no MongoDB connector. This Skill prevents the two dangerous failure modes — advising an impossible v7 upgrade or silently rewriting the app onto SQL — and frames the real decision: migrate to Prisma Next (Early Access MongoDB support) or deliberately stay on v6. ## Core Features & Use Cases - Decision Framework: A blocker-check table that greps the codebase for $transaction usage, verifies MongoDB server version (8.0+ required), and assesses team tolerance for pre-1.0 breaking changes. - API Mapping References: Detailed mappings from v6 client calls ($runCommandRaw, findRaw, aggregateRaw, $transaction) to Prisma Next equivalents (mongoRaw, typed pipeline builder, driver sessions). - Cutover Verification Checklist: A 10-step no-data-moves checklist covering index parity, $jsonSchema validator impact, storage-name addressing, and staged read-only soak before cutover. - Use Case: A team on Prisma 6 with MongoDB asks about upgrading to Prisma 7. The Skill intercepts, explains v7 has no MongoDB connector, checks the codebase for transaction blockers, and walks them through a staged Prisma Next migration against the same database. ## Quick Start Ask the assistant whether your Prisma 6 MongoDB project should upgrade to Prisma 7 and have it check your codebase for migration blockers.

Frequently Asked Questions about prisma-mongodb-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Can I upgrade Prisma 6 MongoDB to Prisma 7?▼

No. Prisma 7 has no MongoDB connector, so v6 is the terminal classic-ORM major for MongoDB projects. The forward path is Prisma Next, where MongoDB support is in Early Access with GA planned after Postgres.

How do I migrate a Prisma MongoDB project to Prisma Next?▼

Author a Next contract describing your existing collections, then run plan, migrate, verify, and sign against a staging copy. No data moves — both stacks read the same database until cutover, and v6 stays deployable as the rollback path.

Does Prisma Next support MongoDB transactions?▼

The Prisma Next Mongo façade does not wrap db.transaction yet, but the underlying mongodb driver is a user-supplied peer dependency. Multi-document atomicity works today via driver sessions with startSession and withTransaction on a replica set.

What MongoDB server version does Prisma Next require?▼

Prisma Next's Mongo target requires MongoDB 8.0 or later and mongodb@^7 installed as a peer dependency. Prisma v6 tolerated older server versions, so verify your server version before planning a migration.

When should I stay on Prisma v6 instead of migrating?▼

Stay on v6 when your codebase relies on multi-document $transaction calls you cannot yet port to driver sessions, or when your team cannot absorb pre-1.0 breaking changes between Next minors. Pin the latest 6.x, keep taking patches, and re-evaluate at GA.