prisma-mongodb-upgrade

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

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/soumeningit/FlowBoard --skill prisma-mongodb-upgrade-soumeningit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prisma-mongodb-upgrade
Source: https://github.com/soumeningit/FlowBoard/tree/main/packages/database/.windsurf/skills/prisma-mongodb-upgrade
Command: npx skills add https://github.com/soumeningit/FlowBoard --skill prisma-mongodb-upgrade-soumeningit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Prisma 7 ships no MongoDB connector, so MongoDB projects on Prisma v6 have no standard upgrade path. This Skill prevents the two common failure modes — advising an impossible Prisma 7 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 (transactions usage, MongoDB 8.0+ server floor, tolerance for pre-1.0 breaking changes) that determines whether to migrate to Prisma Next or stay on the latest v6 line. - Mapping References: Detailed v6-to-Next mappings for schema contracts, client API calls (including raw query and transaction equivalents), and the shift from db push to plan/migrate/verify/sign migrations. - Cutover Verification: A no-data-moves checklist covering index parity, validator impact, storage-name addressing, and staged read-only soak before switching writes. - Use Case: A team on Prisma 6 with provider = "mongodb" asks about upgrading to Prisma 7. The Skill intercepts the question, greps the codebase for $transaction usage, checks the MongoDB server version, and produces a staged migration plan to Prisma Next — or a justified stay-on-v6 hygiene plan. ## Quick Start Ask the assistant to evaluate whether your Prisma v6 MongoDB project should migrate to Prisma Next and to check the 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, map v6 client calls to Next equivalents (storage-name addressing, mongoRaw lane, pipeline builder), then run plan, migrate, verify, and sign. The data never moves — both stacks use the same database until cutover.

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 and fully accessible. Multi-document atomicity works today via driver sessions with startSession and withTransaction on a replica set.

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

Stay on v6 when your codebase relies on $transaction and you cannot plan driver-session equivalents, 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 Prisma Next MongoDB GA.

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 user-supplied peer dependency. Prisma v6 tolerated older server versions, so verify the server version before planning a migration.