docs(): add v7 migration guide

[mhartington]

Summary by CodeRabbit

• Documentation
  • Added an "Upgrade to Prisma ORM 7" guide covering breaking changes, upgrade steps, ESM/TypeScript guidance, schema and config migration examples, driver/adapter patterns, environment loading, metrics/extensions, and migration notes.
  • Added a "Migrating to Prisma 7" migration-assistant prompt with a structured step-by-step plan, validation checks, scripts/CI guidance, seeding and middleware/extension guidance, and safety considerations.
  • Updated upgrade guides index and sidebar to link to the new Prisma 7 migration resources.

[coderabbitai]

Warning

Rate limit exceeded

@mhartington has exceeded the limit for the number of commits or files that can be reviewed per hour. Please wait 21 minutes and 45 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between 8bb61a0 and fa56360.

📒 Files selected for processing (1)

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

Walkthrough

Adds a new "Upgrade to Prisma ORM 7" upgrade guide and a Prisma-7 migration AI prompt, updates the upgrade-guide index and AI prompts sidebar, and introduces docs describing Prisma v7 breaking changes, ESM/TS guidance, prisma.config usage, schema/generator/provider updates, driver adapters, dotenv loading, client extensions, and removed runtime flags.

Changes

Cohort / File(s)	Summary
Prisma 7 Upgrade Guide content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx	New MDX guide documenting Prisma ORM v7 breaking changes and step-by-step upgrade instructions: dependency upgrades, ESM/TS config, schema/generator/provider updates (e.g., prisma-client-js → prisma-client), datasource option deprecations, prisma.config usage, driver adapter examples, explicit dotenv loading, removal of Metrics & Client Middleware, and code/config snippets.
Upgrade Guide Index content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/index.mdx	Adds an entry linking to the new "Upgrade to Prisma ORM 7" guide under "Common upgrade paths" → "Prisma ORM 2 and onwards".
Migration Prompt Doc content/900-ai/prompts/prisma-7.mdx	New AI-assistant MDX prompt "Migrating to Prisma 7" providing a structured multi-step migration plan, role/rules, example diffs, ESM & TypeScript baselines, prisma.config recommendations, Accelerate-aware guidance, scripts/CI suggestions, and verification steps.
Sidebar Registration sidebars.ts	Registers ai/prompts/prisma-7 in the aiSidebar → Prompts list to surface the new prompt doc.
Manifest package.json	Referenced in diff metadata; no inline content changes shown in the summary.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20–30 minutes

• Areas to focus review on:
  • Generator/provider examples switching from prisma-client-js → prisma-client (ensure exact name and CLI alignment).
  • ESM/tsconfig/package.json snippets (module/target/exports correctness).
  • prisma.config examples and removed datasource options (ensure flags and example wiring match v7 behavior).
  • Client instantiation / driver-adapter samples and dotenv loading (verify runtime usage and import patterns).

Possibly related PRs

• Update docs to perform migrations with connection pooling and Prisma config #7266 — Related changes to prisma.config usage, DIRECT_URL/DATABASE_URL handling, and driver-adapter/client wiring present in this guide.
• DC-6174: Remove adapter, engine, directUrl, studio from config #7256 — Overlaps on prisma.config.ts examples and removal of deprecated datasource properties referenced in the new guide.
• Update 300-no-rust-engine.mdx #7125 — Matches generator provider updates replacing prisma-client-js with prisma-client, directly connected to schema/generator examples.

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 accurately reflects the main objective: adding a comprehensive v7 migration guide across multiple documentation files and integration into the sidebar navigation.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

---

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]

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	2399
✅ Successful	2369
⏳ Timeouts	0
🔀 Redirected	7
👻 Excluded	21
❓ Unknown	0
🚫 Errors	1
⛔ Unsupported	1

Errors per input

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

• [ERROR] file:///home/runner/work/docs/docs/content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/orm/prisma-client/client-extensions | Cannot find file: File not found. Check if file exists and path is correct

[cloudflare-workers-and-pages]

Deploying docs with    Cloudflare Pages

Latest commit:	fa56360
Status:	🚫  Build failed.

View logs

[coderabbitai]

Actionable comments posted: 3

🧹 Nitpick comments (1)

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

79-82: Clarify the ESM Support section opening sentence.

The opening sentence at line 80–81 reads: "Prisma ORM now ships as an ES module, module format supported in Bun, Deno, and Node." The phrasing is slightly awkward with the repeated "module" concept. Consider rephrasing for clarity:

"Prisma ORM now ships as an ES module, a module format supported in Bun, Deno, and Node." (adding "a" for grammatical flow)

or

"Prisma ORM now ships as an ES module—a format supported in Bun, Deno, and Node."

📜 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 3bf085d and 5347a7c.

📒 Files selected for processing (2)

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

🧰 Additional context used

🧠 Learnings (4)

📚 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/index.mdx

📚 Learning: 2025-10-08T16:23:00.388Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: All headings and titles should use sentence case (e.g., "Getting started with Prisma ORM", "Best practices for authentication"), not title case. Exception: Always preserve exact casing for product names including "Prisma Postgres", "Prisma", "Prisma ORM", and "Prisma Data Platform".

Applied to files:

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

📚 Learning: 2025-10-08T16:22:57.129Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:50-66
Timestamp: 2025-10-08T16:22:57.129Z
Learning: In `.mdx` files, do NOT flag or suggest changes for the following code quality issues even if they represent poor practices: React anti-patterns (using var instead of useState, direct DOM manipulation), missing keys in .map() iterations, non-serializable props in getServerSideProps, unused variables, missing error handling, SQL injection vulnerabilities (unless actively showing how to fix them), insecure cookie settings, missing TypeScript types, PrismaClient instantiation patterns, or any other code quality, security, or performance issues. Documentation code snippets are copied from source code and often intentionally show "before" examples or common mistakes.

Applied to files:

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

📚 Learning: 2025-10-08T16:23:00.388Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: Only flag code snippets for (1) exposed secrets with real-looking values that should be placeholders (e.g., API keys, database passwords, AWS credentials), or (2) blatant syntax errors like missing parentheses, brackets, braces, or mismatched delimiters. Do not flag code quality issues, anti-patterns, security vulnerabilities, missing error handling, unused variables, or any other bad practices, as documentation intentionally shows problematic code.

Applied to files:

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

🪛 LanguageTool

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

[grammar] ~132-~132: Ensure spelling is correct
Context: ...s with the move to make the main Prisma Clinet as lean and open as possible. For insta...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

⏰ 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). (3)

• GitHub Check: runner / linkspector
• GitHub Check: Check internal links
• GitHub Check: Cloudflare Pages

🔇 Additional comments (1)

content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/index.mdx (1)

27-27: Excellent placement and formatting of the new upgrade guide link.

The new link to the Prisma ORM 7 upgrade guide is properly positioned first in the list (following logical version ordering), correctly formatted, and seamlessly integrated with the existing structure. Well done.

[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	2244
✅ Successful	2212
⏳ Timeouts	0
🔀 Redirected	7
👻 Excluded	22
❓ Unknown	0
🚫 Errors	2
⛔ Unsupported	1

Errors per input

Errors in 200-orm/050-overview/100-introduction/250-should-you-use-prisma.mdx

• [ERROR] https://nexusjs.org/docs/plugins/prisma/overview | Error (cached)

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

• [ERROR] file:///home/runner/work/docs/docs/content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/orm/prisma-client/client-extensions | Cannot find file: File not found. Check if file exists and path is correct

[coderabbitai]

Actionable comments posted: 1

📜 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 5347a7c and 5f88326.

📒 Files selected for processing (3)

• content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx (1 hunks)
• content/900-ai/prompts/prisma-7.mdx (1 hunks)
• sidebars.ts (1 hunks)

🧰 Additional context used

🧠 Learnings (6)

📚 Learning: 2025-10-08T16:23:00.388Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: Only flag code snippets for (1) exposed secrets with real-looking values that should be placeholders (e.g., API keys, database passwords, AWS credentials), or (2) blatant syntax errors like missing parentheses, brackets, braces, or mismatched delimiters. Do not flag code quality issues, anti-patterns, security vulnerabilities, missing error handling, unused variables, or any other bad practices, as documentation intentionally shows problematic code.

Applied to files:

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

📚 Learning: 2025-10-08T16:22:57.129Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:50-66
Timestamp: 2025-10-08T16:22:57.129Z
Learning: In `.mdx` files, do NOT flag or suggest changes for the following code quality issues even if they represent poor practices: React anti-patterns (using var instead of useState, direct DOM manipulation), missing keys in .map() iterations, non-serializable props in getServerSideProps, unused variables, missing error handling, SQL injection vulnerabilities (unless actively showing how to fix them), insecure cookie settings, missing TypeScript types, PrismaClient instantiation patterns, or any other code quality, security, or performance issues. Documentation code snippets are copied from source code and often intentionally show "before" examples or common mistakes.

Applied to files:

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

📚 Learning: 2025-10-08T16:23:00.388Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: All headings and titles should use sentence case (e.g., "Getting started with Prisma ORM", "Best practices for authentication"), not title case. Exception: Always preserve exact casing for product names including "Prisma Postgres", "Prisma", "Prisma ORM", and "Prisma Data Platform".

Applied to files:

• content/900-ai/prompts/prisma-7.mdx
• 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/900-ai/prompts/prisma-7.mdx
• content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx

📚 Learning: 2025-10-10T13:13:30.534Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7167
File: content/900-ai/prompts/astro.mdx:84-85
Timestamp: 2025-10-10T13:13:30.534Z
Learning: Do not review or comment on files in the `ai/prompts/` directory or matching the path pattern `content/900-ai/prompts/` in the prisma/docs repository.

Applied to files:

• sidebars.ts

📚 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

🪛 LanguageTool

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

[grammar] ~148-~148: Ensure spelling is correct
Context: ...s with the move to make the main Prisma Clinet as lean and open as possible. For insta...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

---

[grammar] ~257-~257: Ensure spelling is correct
Context: ...n use the underlying driver adapter for you database, or Client Extensions to make ...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

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

sidebars.ts (1)

537-537: LGTM! Navigation entry properly added.

The addition of the Prisma 7 migration prompt to the AI sidebar follows the existing pattern and correctly integrates the new documentation.

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

1-323: Excellent comprehensive coverage of breaking changes.

This migration guide provides thorough documentation of all major breaking changes in Prisma ORM v7, with clear before/after examples for each change. The structure logically guides users through the upgrade process, covering dependencies, schema changes, client instantiation, environment variables, configuration, and API changes.

content/900-ai/prompts/prisma-7.mdx (1)

1-298: Skipping review per repository guidelines.

Based on learnings, files in the content/900-ai/prompts/ directory should not be reviewed.

[coderabbitai]

Actionable comments posted: 1

♻️ Duplicate comments (8)

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

82-105: Use sentence case for the "ESM support" heading.

Line 82 uses title case; it should be sentence case per documentation standards. Change "ESM Support" → "ESM support".

---

108-128: Use sentence case for the "Prisma schema changes" heading.

Line 108 uses title case; it should be sentence case per documentation standards. Change "Prisma Schema Changes" → "Prisma schema changes".

---

146-150: Use sentence case for the "Driver adapters and client instantiation" heading.

Line 146 uses title case; it should be sentence case per documentation standards. Change "Driver Adapters and Client Instantiation" → "Driver adapters and client instantiation".

---

189-189: Use sentence case for the "Explicit loading of environment variables" heading.

Line 189 uses title case; it should be sentence case per documentation standards. Change "Explicit loading of Environment Variables" → "Explicit loading of environment variables".

---

254-283: Use sentence case for the "Metrics has been removed from the client extensions" heading.

Line 254 uses title case; it should be sentence case per documentation standards. Change "Metrics has been removed from the Client extensions" → "Metrics has been removed from the client extensions".

---

285-306: Use sentence case for the "Client middleware has been removed" heading.

Line 285 uses title case; it should be sentence case per documentation standards. Change "Client Middleware has been removed" → "Client middleware has been removed".

---

148-148: Fix typo: "Clinet" should be "Client".

Line 148 contains a spelling error that should be corrected.

Apply this diff:

-This change aligns with the move to make the main Prisma Clinet as lean and open as possible. For
+This change aligns with the move to make the main Prisma Client as lean and open as possible. For

---

132-143: Fix syntax error: missing comma after directUrl property.

Line 139 is missing a trailing comma, which breaks the TypeScript/JavaScript object literal syntax.

Apply this diff:

 export default defineConfig({
   datasource: {
     url: env('DATABASE_URL'),
-    directUrl: env('DIRECT_URL')
+    directUrl: env('DIRECT_URL'),
     shadowDatabaseUrl: env('SHADOW_DATABASE_URL')
   },
 })

📜 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 5f88326 and 5437788.

📒 Files selected for processing (1)

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

🧰 Additional context used

🧠 Learnings (5)

📚 Learning: 2025-10-08T16:23:00.388Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: All headings and titles should use sentence case (e.g., "Getting started with Prisma ORM", "Best practices for authentication"), not title case. Exception: Always preserve exact casing for product names including "Prisma Postgres", "Prisma", "Prisma ORM", and "Prisma Data Platform".

Applied to files:

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

📚 Learning: 2025-10-08T16:23:00.388Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: Only flag code snippets for (1) exposed secrets with real-looking values that should be placeholders (e.g., API keys, database passwords, AWS credentials), or (2) blatant syntax errors like missing parentheses, brackets, braces, or mismatched delimiters. Do not flag code quality issues, anti-patterns, security vulnerabilities, missing error handling, unused variables, or any other bad practices, as documentation intentionally shows problematic code.

Applied to files:

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

📚 Learning: 2025-10-08T16:22:57.129Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:50-66
Timestamp: 2025-10-08T16:22:57.129Z
Learning: In `.mdx` files, do NOT flag or suggest changes for the following code quality issues even if they represent poor practices: React anti-patterns (using var instead of useState, direct DOM manipulation), missing keys in .map() iterations, non-serializable props in getServerSideProps, unused variables, missing error handling, SQL injection vulnerabilities (unless actively showing how to fix them), insecure cookie settings, missing TypeScript types, PrismaClient instantiation patterns, or any other code quality, security, or performance issues. Documentation code snippets are copied from source code and often intentionally show "before" examples or common mistakes.

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

📚 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

🪛 LanguageTool

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

[grammar] ~148-~148: Ensure spelling is correct
Context: ...s with the move to make the main Prisma Clinet as lean and open as possible. For insta...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

---

[grammar] ~257-~257: Ensure spelling is correct
Context: ...n use the underlying driver adapter for you database, or Client Extensions to make ...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

⏰ 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). (3)

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

🔇 Additional comments (2)

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

1-21: Frontmatter and introduction look good.

The metadata is properly formatted, and the introduction clearly sets expectations. The reference to the migration prompt on line 20 aligns well with the broader upgrade flow.

---

23-69: Package upgrade commands are clearly presented across all package managers.

The tabbed content is well-structured, and the danger callout appropriately warns users to review breaking changes beforehand.

[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	2244
✅ Successful	2214
⏳ Timeouts	0
🔀 Redirected	6
👻 Excluded	22
❓ Unknown	0
🚫 Errors	1
⛔ Unsupported	1

Errors per input

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

• [ERROR] file:///home/runner/work/docs/docs/content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/orm/prisma-client/client-extensions | Cannot find file: File not found. Check if file exists and path is correct

[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	2244
✅ Successful	2217
⏳ Timeouts	0
🔀 Redirected	3
👻 Excluded	22
❓ Unknown	0
🚫 Errors	1
⛔ Unsupported	1

Errors per input

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

• [ERROR] file:///home/runner/work/docs/docs/content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/orm/prisma-client/client-extensions | Cannot find file: File not found. Check if file exists and path is correct

[coderabbitai]

Actionable comments posted: 1

♻️ Duplicate comments (4)

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

257-257: Fix grammar: "for you database" should be "for your database".

-If you need this feature, you can use the underlying driver adapter for you database, or Client Extensions to make this information available.
+If you need this feature, you can use the underlying driver adapter for your database, or Client Extensions to make this information available.

---

254-254: Use sentence case for heading: "client extensions" not "Client extensions".

Per documentation style guidelines, headings should use sentence case. "Client" here is not a product name and should be lowercase.

-### Metrics has been removed from the Client extensions
+### Metrics has been removed from the client extensions

---

139-139: Fix syntax error: Missing comma in configuration object.

The directUrl property is missing a trailing comma, which will cause a syntax error when the config is evaluated.

 export default defineConfig({
   datasource: {
     url: env('DATABASE_URL'),
-    directUrl: env('DIRECT_URL')
+    directUrl: env('DIRECT_URL'),
     shadowDatabaseUrl: env('SHADOW_DATABASE_URL')
   },
 })

---

148-148: Fix typo: "Clinet" should be "Client".

Line 148 contains a spelling error that should be corrected.

-This change aligns with the move to make the main Prisma Clinet as lean and open as possible. For
+This change aligns with the move to make the main Prisma Client as lean and open as possible. For

📜 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 5437788 and eb9475c.

📒 Files selected for processing (1)

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

🧰 Additional context used

🧠 Learnings (5)

📚 Learning: 2025-10-08T16:23:00.388Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: All headings and titles should use sentence case (e.g., "Getting started with Prisma ORM", "Best practices for authentication"), not title case. Exception: Always preserve exact casing for product names including "Prisma Postgres", "Prisma", "Prisma ORM", and "Prisma Data Platform".

Applied to files:

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

📚 Learning: 2025-10-08T16:23:00.388Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: Only flag code snippets for (1) exposed secrets with real-looking values that should be placeholders (e.g., API keys, database passwords, AWS credentials), or (2) blatant syntax errors like missing parentheses, brackets, braces, or mismatched delimiters. Do not flag code quality issues, anti-patterns, security vulnerabilities, missing error handling, unused variables, or any other bad practices, as documentation intentionally shows problematic code.

Applied to files:

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

📚 Learning: 2025-10-08T16:22:57.129Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:50-66
Timestamp: 2025-10-08T16:22:57.129Z
Learning: In `.mdx` files, do NOT flag or suggest changes for the following code quality issues even if they represent poor practices: React anti-patterns (using var instead of useState, direct DOM manipulation), missing keys in .map() iterations, non-serializable props in getServerSideProps, unused variables, missing error handling, SQL injection vulnerabilities (unless actively showing how to fix them), insecure cookie settings, missing TypeScript types, PrismaClient instantiation patterns, or any other code quality, security, or performance issues. Documentation code snippets are copied from source code and often intentionally show "before" examples or common mistakes.

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

📚 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

⏰ 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

[coderabbitai]

Actionable comments posted: 0

♻️ Duplicate comments (3)

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

285-285: Use sentence case for heading: "client middleware" not "Client middleware".

Per documentation style guidelines (as established in retrieved learnings), this heading should follow sentence case with lowercase for non-product-name nouns.

-### Client middleware has been removed
+### Client middleware has been removed

---

257-257: Fix grammar: "for you database" should be "for your database".

This is a straightforward possessive pronoun correction needed for proper grammar.

-If you need this feature, you can use the underlying driver adapter for you database, or Client Extensions to make this information available.
+If you need this feature, you can use the underlying driver adapter for your database, or Client Extensions to make this information available.

---

132-143: Fix syntax error: Missing comma after directUrl property.

The directUrl property is missing a trailing comma, which breaks the object literal syntax. This configuration example will fail if copied directly.

 export default defineConfig({
   datasource: {
     url: env('DATABASE_URL'),
-    directUrl: env('DIRECT_URL')
+    directUrl: env('DIRECT_URL'),
     shadowDatabaseUrl: env('SHADOW_DATABASE_URL')
   },
 })

🧹 Nitpick comments (1)

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

254-254: Use sentence case for heading: "client extensions" not "Client extensions".

Per documentation style guidelines, "client" here is not a product name and should use lowercase in sentence case.

-### Metrics has been removed from the Client extensions
+### Metrics has been removed from the client extensions

📜 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 eb9475c and 8bb61a0.

📒 Files selected for processing (1)

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

🧰 Additional context used

🧠 Learnings (5)

📚 Learning: 2025-10-08T16:23:00.388Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: All headings and titles should use sentence case (e.g., "Getting started with Prisma ORM", "Best practices for authentication"), not title case. Exception: Always preserve exact casing for product names including "Prisma Postgres", "Prisma", "Prisma ORM", and "Prisma Data Platform".

Applied to files:

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

📚 Learning: 2025-10-08T16:23:00.388Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: Only flag code snippets for (1) exposed secrets with real-looking values that should be placeholders (e.g., API keys, database passwords, AWS credentials), or (2) blatant syntax errors like missing parentheses, brackets, braces, or mismatched delimiters. Do not flag code quality issues, anti-patterns, security vulnerabilities, missing error handling, unused variables, or any other bad practices, as documentation intentionally shows problematic code.

Applied to files:

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

📚 Learning: 2025-10-08T16:22:57.129Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:50-66
Timestamp: 2025-10-08T16:22:57.129Z
Learning: In `.mdx` files, do NOT flag or suggest changes for the following code quality issues even if they represent poor practices: React anti-patterns (using var instead of useState, direct DOM manipulation), missing keys in .map() iterations, non-serializable props in getServerSideProps, unused variables, missing error handling, SQL injection vulnerabilities (unless actively showing how to fix them), insecure cookie settings, missing TypeScript types, PrismaClient instantiation patterns, or any other code quality, security, or performance issues. Documentation code snippets are copied from source code and often intentionally show "before" examples or common mistakes.

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

📚 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

🪛 LanguageTool

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

[grammar] ~257-~257: Ensure spelling is correct
Context: ...n use the underlying driver adapter for you database, or Client Extensions to make ...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

⏰ 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

[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	2244
✅ Successful	2215
⏳ Timeouts	0
🔀 Redirected	5
👻 Excluded	22
❓ Unknown	0
🚫 Errors	1
⛔ Unsupported	1

Errors per input

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

• [ERROR] file:///home/runner/work/docs/docs/content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/orm/prisma-client/client-extensions | Cannot find file: File not found. Check if file exists and path is correct