Skip to content

Conversation

@mhartington
Copy link
Contributor

@mhartington mhartington commented Nov 11, 2025

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
Copy link
Contributor

coderabbitai bot commented Nov 11, 2025

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-jsprisma-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-jsprisma-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

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

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

@github-actions
Copy link
Contributor

Dangerous URL check

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

@github-actions
Copy link
Contributor

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
Copy link
Contributor

🍈 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
Copy link

cloudflare-workers-and-pages bot commented Nov 11, 2025

Deploying docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: fa56360
Status:🚫  Build failed.

View logs

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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
Copy link
Contributor

🍈 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

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

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

mhartington and others added 2 commits November 17, 2025 19:22
…ions/400-upgrading-to-prisma-7.mdx

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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
Copy link
Contributor

🍈 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
Copy link
Contributor

🍈 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

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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
Copy link
Contributor

🍈 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

@mhartington mhartington merged commit 6119439 into prisma-7 Nov 18, 2025
3 of 6 checks passed
@mhartington mhartington deleted the migration-v7 branch November 18, 2025 12:38
aidankmcalister pushed a commit that referenced this pull request Nov 18, 2025
* docs(): add v7 migration guide

* docs(): update based on feedback

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

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* docs(): update based on feedback

* docs(): update based on feedback

* docs(): update based on feedback

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants