cf worker guide changes

[aidankmcalister]

Summary by CodeRabbit

• Documentation
  • Restructured Cloudflare Workers with Prisma setup guide for improved clarity.
  • Enhanced code examples and integration instructions.
  • Added documentation on supported runtimes.
  • Reorganized sections to follow a logical workflow from schema configuration through testing.

_{✏️ 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/800-guides/410-cloudflare-workers.mdx	content/800-guides/410-cloudflare-workers.mdx

[github-actions]

Redirect check

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

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

[coderabbitai]

Walkthrough

This PR restructures the Cloudflare Workers integration guide for Prisma, reorganizing setup steps, updating code examples to specify cloudflare runtime in the Prisma schema generator, and expanding integration examples with per-request PrismaClient initialization patterns and additional guidance sections.

Changes

Cohort / File(s)

Summary

Cloudflare Workers guide restructuring content/800-guides/410-cloudflare-workers.mdx

Reorganized setup flow from a config-focused approach to a schema-first approach; updated wrangler.jsonc code fence language; replaced environment types section with explicit Prisma schema examples; renumbered sections 2.3–2.5; added runtime support note for cloudflare and workerd; expanded section 3 with concrete per-request PrismaClient initialization, user creation/counting examples, local testing, and Prisma Studio instructions; updated package.json script examples to include migrate, generate, and studio commands.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

• Verify code examples are syntactically correct and align with current Prisma/Cloudflare API
• Check that the schema-first narrative flow and section renumbering maintain logical coherence
• Confirm runtime configuration examples (cloudflare and workerd) match supported values
• Validate that per-request PrismaClient patterns follow Prisma best practices for serverless environments

Possibly related PRs

• Update Cloudflare D1 Guides #7273 — Overlaps with runtime = "cloudflare" modifications in Cloudflare Prisma guides and related integration setup snippets
• DC-5245 Cloudflare Worker Guide #7301 — Modifies the same file (cloudflare-workers.mdx) with overlapping changes to Prisma schema runtime configuration, per-request usage patterns, wrangler config, and package.json scripts

Pre-merge checks

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Title check	❓ Inconclusive	The title 'cf worker guide changes' is vague and generic, lacking specificity about what aspect of the Cloudflare Workers guide was improved.	Revise the title to be more specific about the primary change, such as 'Restructure Cloudflare Workers guide with Prisma schema-first approach' or 'Update Cloudflare Workers integration guide with improved Prisma setup steps'.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
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 70cd03e and 5f116f6.

⛔ Files ignored due to path filters (1)

• static/img/guides/prisma-cloudflare-workers-cover.png is excluded by !**/*.png

📒 Files selected for processing (1)

• content/800-guides/410-cloudflare-workers.mdx (4 hunks)

🧰 Additional context used

🧠 Learnings (6)

📓 Common learnings

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

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

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7301
File: content/800-guides/410-cloudflare-workers.mdx:87-107
Timestamp: 2025-11-20T21:00:02.521Z
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/800-guides/410-cloudflare-workers.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/800-guides/410-cloudflare-workers.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/800-guides/410-cloudflare-workers.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/800-guides/410-cloudflare-workers.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/800-guides/410-cloudflare-workers.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). (1)

• GitHub Check: Cloudflare Pages

🔇 Additional comments (1)

content/800-guides/410-cloudflare-workers.mdx (1)

72-345: Well-structured restructuring with clear progression.

The reorganization flows logically from schema setup through Prisma configuration and into practical integration patterns. The per-request PrismaClient initialization pattern (section 3.3) is correctly presented as the appropriate approach for edge environments, with a helpful warning clarifying why this differs from traditional Node.js server patterns. All headings maintain proper sentence case, code examples are syntactically sound, and the integration examples demonstrate practical, complete workflows without exposing secrets.

---

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

[github-actions]

Images automagically compressed by Calibre's image-actions ✨

Compression reduced images by 86.8%, saving 357.3 KB.

Filename	Before	After	Improvement	Visual comparison
static/img/guides/prisma-cloudflare-workers-cover.png	411.8 KB	54.5 KB	86.8%	View diff

[cloudflare-workers-and-pages]

Deploying docs with    Cloudflare Pages

Latest commit:	1d65e45
Status:	⚡️  Build in progress...

View logs