DC-6387 Add required output field and import changes to Prisma 7 upgrade documentation

[ArthurGamby]

Summary by CodeRabbit

• Documentation
  • Updated Prisma 7 upgrade guide with required generator configuration changes, including mandatory output field setup and custom output paths.
  • Added examples for updating import paths based on configuration.
  • Documented deprecated datasource fields and provided migration instructions.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

This documentation update to the Prisma 7 upgrade guide explains breaking changes to the generator configuration, including the now-required output field, the provider name change from prisma-client-js to prisma-client, updated import paths, and datasource field deprecations with migration guidance.

Changes

Cohort / File(s)	Summary
Prisma 7 Generator and Import Path Updates content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx	Adds guidance requiring explicit output field in generator block, explains provider name change to prisma-client, includes before/after import path examples, clarifies import path dependency on output configuration, and documents datasource field deprecations with migration strategy for directUrl to url.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Note: This is a documentation-only change affecting a single markdown file. Review should focus on factual accuracy of the breaking change descriptions, particularly around the generator provider renaming, output path requirements, and datasource field migration guidance.

Possibly related PRs

• (fix) Remove Direct URL from Prisma 7 Migration guide #7286 — Modifies the same upgrade guide file with overlapping changes to directUrl deprecation guidance and migration instructions.
• Update 300-no-rust-engine.mdx #7125 — Updates generator block examples by switching the provider from prisma-client-js to prisma-client, mirroring the core breaking change documented here.
• fix import paths in getting started tutorials #7100 — Updates Prisma Client import statements to reference the new generated output path instead of @prisma/client, addressing the import path changes introduced in this guide.

Pre-merge checks

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and specifically describes the main change: adding documentation about the required output field and import path changes for Prisma 7, which directly aligns with the changeset content.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

---

📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2076e5a and 4dcb60f.

📒 Files selected for processing (1)

• content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx (2 hunks)

🧰 Additional context used

🧠 Learnings (4)

📓 Common learnings

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7301
File: content/800-guides/410-cloudflare-workers.mdx:87-107
Timestamp: 2025-11-20T21:00:02.587Z
Learning: Do not suggest changes to `prisma.config.ts` files in the prisma/docs repository, as the code examples are intentional for documentation purposes.

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7167
File: content/900-ai/prompts/astro.mdx:84-84
Timestamp: 2025-10-09T21:32:50.340Z
Learning: The `npx prisma init` command supports the following flags: `--db` (shorthand for `--datasource-provider prisma+postgres`), `--output` (specifies output location for generated client), `--generator-provider` (defines the generator provider), `--datasource-provider`, `--url`, `--preview-feature`, and `--with-model`. These are documented valid CLI options for Prisma init command.

📚 Learning: 2025-10-09T21:32:50.340Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7167
File: content/900-ai/prompts/astro.mdx:84-84
Timestamp: 2025-10-09T21:32:50.340Z
Learning: The `npx prisma init` command supports the following flags: `--db` (shorthand for `--datasource-provider prisma+postgres`), `--output` (specifies output location for generated client), `--generator-provider` (defines the generator provider), `--datasource-provider`, `--url`, `--preview-feature`, and `--with-model`. These are documented valid CLI options for Prisma init command.

Applied to files:

• content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx

📚 Learning: 2025-11-20T21:00:02.587Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7301
File: content/800-guides/410-cloudflare-workers.mdx:87-107
Timestamp: 2025-11-20T21:00:02.587Z
Learning: Do not suggest changes to `prisma.config.ts` files in the prisma/docs repository, as the code examples are intentional for documentation purposes.

Applied to files:

• content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx

📚 Learning: 2025-08-11T09:40:55.237Z

Learnt from: ankur-arch
Repo: prisma/docs PR: 7066
File: content/200-orm/200-prisma-client/700-debugging-and-troubleshooting/245-troubleshooting-binary-size-issues.mdx:8-22
Timestamp: 2025-08-11T09:40:55.237Z
Learning: When the queryCompiler preview feature is enabled in Prisma ORM (v6.7.0+), it does not require Rust engines for CLI tools like `prisma migrate` or `prisma db pull`. The previous understanding that CLI tools would still need Rust binaries even with queryCompiler enabled is incorrect.

Applied to files:

• content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)

• GitHub Check: Check internal links
• GitHub Check: Cloudflare Pages

🔇 Additional comments (3)

content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx (3)

121-137: Clear and accurate documentation of the required output field change.

The before/after examples effectively communicate the breaking change. The concrete example (output = "./generated/prisma") provides helpful guidance, and the implicit removal of engineType = "binary" is correctly shown in the After block.

---

139-153: Import path migration guidance is well-structured and helpful.

The before/after import examples clearly show the transition from @prisma/client to the generated path, and the accompanying note appropriately acknowledges that paths depend on individual configuration. This teaches users to think through their specific setup rather than blindly copying.

---

193-193: Import paths in driver adapter examples are consistent with new guidance.

The driver adapter section (lines 193 and 205) correctly uses the new import path ./generated/prisma/client, which aligns perfectly with the guidance in the earlier section. This consistency reinforces the migration path for users reading through the entire upgrade guide.

Also applies to: 205-205

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

Dangerous URL check

No absolute URLs to prisma.io/docs found.
No local URLs found.

[github-actions]

original	preview
content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx	content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx

[github-actions]

Redirect check

This PR probably requires the following redirects to be added to static/_redirects:

• This PR does not change any pages in a way that would require a redirect.

[github-actions]

🍈 Lychee Link Check Report

Note: Links are cached for 5 minutes. Failed links (timeouts, rate limits) are retried in a second run with longer timeout.

📊 Results Overview

Status	Count
🔍 Total	2268
✅ Successful	2237
⏳ Timeouts	0
🔀 Redirected	5
👻 Excluded	24
❓ Unknown	0
🚫 Errors	1
⛔ Unsupported	1

Errors per input

Errors in 200-orm/050-overview/100-introduction/300-data-modeling.mdx

• [404] https://www.mongodb.com/docs/manual/data-modeling/concepts/embedding-vs-references/#references | Error (cached)

[cloudflare-workers-and-pages]

Deploying docs with    Cloudflare Pages

Latest commit:	47ffde1
Status:	✅  Deploy successful!
Preview URL:	https://d3180027.docs-51g.pages.dev
Branch Preview URL:	https://dc-6387-generate-client-ment.docs-51g.pages.dev

View logs

[github-actions]

🍈 Lychee Link Check Report

Note: Links are cached for 5 minutes. Failed links (timeouts, rate limits) are retried in a second run with longer timeout.

📊 Results Overview

Status	Count
🔍 Total	2268
✅ Successful	2237
⏳ Timeouts	0
🔀 Redirected	5
👻 Excluded	24
❓ Unknown	0
🚫 Errors	1
⛔ Unsupported	1

Errors per input

Errors in 200-orm/050-overview/100-introduction/300-data-modeling.mdx

• [404] https://www.mongodb.com/docs/manual/data-modeling/concepts/embedding-vs-references/#references | Error (cached)