DC-6442 Update nextjs ai prompt guide from prisma@6 to prisma@7

[ArthurGamby]

Summary by CodeRabbit

• Documentation
  • Updated Next.js documentation with improved structure, added prerequisites, and enhanced Prisma integration guidance.

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

[github-actions]

Dangerous URL check

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

[github-actions]

original	preview
content/900-ai/prompts/nextjs.mdx	content/900-ai/prompts/nextjs.mdx

[coderabbitai]

Walkthrough

Documentation content updates to the Next.js AI prompt file, including restructured headings, added prerequisites section, updated Prisma/Next.js guidance, and new instruction blocks. No changes to code logic or public APIs.

Changes

Cohort / File(s)	Summary
Documentation restructuring content/900-ai/prompts/nextjs.mdx	Renamed headings, added prerequisites section, updated Prisma and Next.js integration guidance, and introduced new instruction blocks for improved clarity

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Single documentation file with content-only updates
• No code logic, API signatures, or public interfaces affected
• Review focus: verify accuracy of updated guidance and consistency of documentation structure

Possibly related PRs

• DC-5274-nextjs-ai-prompt #7212: Initially added the content/900-ai/prompts/nextjs.mdx file and integrated it into the sidebar; this PR refines its content with structural and guidance updates

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 directly describes the main change: updating Next.js AI prompt documentation from Prisma v6 to v7. It's specific, concise, and clearly relates to the file being modified.
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 f21ef66 and 67d9115.

📒 Files selected for processing (1)

• content/900-ai/prompts/nextjs.mdx (12 hunks)

🧰 Additional context used

🧠 Learnings (8)

📓 Common learnings

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.

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: 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.

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.

📚 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/nextjs.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/900-ai/prompts/nextjs.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/900-ai/prompts/nextjs.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/nextjs.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:

• content/900-ai/prompts/nextjs.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/900-ai/prompts/nextjs.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/nextjs.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). (3)

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

---

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]

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.

[cloudflare-workers-and-pages]

Deploying docs with    Cloudflare Pages

Latest commit:	67d9115
Status:	✅  Deploy successful!
Preview URL:	https://e2de0b19.docs-51g.pages.dev
Branch Preview URL:	https://dc-6442-update-nextjs-ai-pro.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	2011
⏳ Timeouts	0
🔀 Redirected	213
👻 Excluded	24
❓ Unknown	0
🚫 Errors	19
⛔ Unsupported	1

Errors per input

Errors in 100-getting-started/02-prisma-orm/100-quickstart/400-mysql.mdx

• [ERROR] https://www.mysql.com/ | Error (cached)

Errors in 100-getting-started/02-prisma-orm/200-add-to-existing-project/400-mysql.mdx

• [ERROR] https://www.mysql.com/ | Error (cached)

Errors in 200-orm/050-overview/500-databases/400-mysql.mdx

• [ERROR] https://dev.mysql.com/doc/refman/8.0/en/creating-database.html | Error (cached)
• [ERROR] https://www.mysql.com/ | Error (cached)

Errors in 200-orm/100-prisma-schema/20-data-model/20-relations/410-referential-actions/index.mdx

• [ERROR] https://dev.mysql.com/doc/refman/8.0/en/create-table-foreign-keys.html#foreign-key-referential-actions | Error (cached)

Errors in 200-orm/100-prisma-schema/20-data-model/20-relations/420-relation-mode.mdx

• [ERROR] https://dev.mysql.com/doc/refman/8.0/en/constraint-foreign-key.html#:~:text=MySQL%20requires%20that%20foreign%20key%20columns%20be%20indexed%3B%20if%20you%20create%20a%20table%20with%20a%20foreign%20key%20constraint%20but%20no%20index%20on%20a%20given%20column%2C%20an%20index%20is%20created. | Error (cached)

Errors in 200-orm/100-prisma-schema/20-data-model/30-indexes.mdx

• [ERROR] https://dev.mysql.com/doc/refman/8.0/en/innodb-limits.html | Error (cached)

Errors in 200-orm/100-prisma-schema/20-data-model/40-views.mdx

• [ERROR] https://dev.mysql.com/doc/refman/8.0/en/view-updatability.html | Error (cached)

Errors in 200-orm/200-prisma-client/100-queries/058-transactions.mdx

• [ERROR] https://dev.mysql.com/doc/refman/8.0/en/innodb-transaction-isolation-levels.html | Error (cached)

Errors in 200-orm/200-prisma-client/100-queries/060-full-text-search.mdx

• [ERROR] https://dev.mysql.com/doc/refman/8.0/en/fulltext-boolean.html | Error (cached)

Errors in 200-orm/200-prisma-client/100-queries/070-case-sensitivity.mdx

• [ERROR] https://dev.mysql.com/doc/refman/8.0/en/charset-collation-names.html | Error (cached)

Errors in 200-orm/200-prisma-client/150-using-raw-sql/200-raw-queries.mdx

• [ERROR] https://dev.mysql.com/doc/refman/8.0/en/sql-prepared-statements.html | Error (cached)

Errors in 200-orm/200-prisma-client/200-special-fields-and-types/100-working-with-json-fields.mdx

• [ERROR] https://dev.mysql.com/doc/refman/8.0/en/json.html#json-path-syntax | Error (cached)

Errors in 200-orm/300-prisma-migrate/050-getting-started.mdx

• [ERROR] https://dev.mysql.com/doc/refman/8.0/en/mysqldump.html | Error (cached)

Errors in 200-orm/300-prisma-migrate/300-workflows/90-development-and-production.mdx

• [ERROR] https://dev.mysql.com/doc/refman/5.7/en/locking-functions.html | Error (cached)

Errors in 200-orm/500-reference/100-prisma-schema-reference.mdx

• [ERROR] https://dev.mysql.com/doc/refman/8.0/en/date-and-time-functions.html#function_current-timestamp | Error (cached)
• [ERROR] https://dev.mysql.com/doc/refman/8.0/en/example-auto-increment.html | Error (cached)
• [ERROR] https://dev.mysql.com/doc/refman/8.3/en/date-and-time-types.html#:~:text=The%20following%20table%20shows%20the%20format%20of%20the%20%E2%80%9Czero%E2%80%9D%20value%20for%20each%20type | Error (cached)

Errors in 200-orm/500-reference/350-database-features.mdx

• [ERROR] https://dev.mysql.com/doc/refman/8.0/en/create-table-check-constraints.html | Error (cached)