Skip to content

feat(docs): add Netlify and Vercel Compute migration guides#7868

Closed
aidankmcalister wants to merge 2 commits intodocs/prisma-compute-quickstartfrom
feat/netlify-and-vercel-migration-guides
Closed

feat(docs): add Netlify and Vercel Compute migration guides#7868
aidankmcalister wants to merge 2 commits intodocs/prisma-compute-quickstartfrom
feat/netlify-and-vercel-migration-guides

Conversation

@aidankmcalister
Copy link
Copy Markdown
Member

@aidankmcalister aidankmcalister commented May 5, 2026

Summary

Adds migration guides for moving existing Netlify and Vercel deployments to Prisma Compute, in both the public and internal docs.

  • compute/guides/netlify.mdx, compute/guides/vercel.mdx — public migration guides
  • compute-internal/guides/netlify.mdx, compute-internal/guides/vercel.mdx — internal versions using @prisma/cli@preview

Each guide covers prerequisites, framework prep (Next.js, TanStack Start, Astro, Nuxt, Bun), local build, deploy, and traffic cutover. Framework prep is in expand-by-default accordions so users can jump straight to their stack.

TanStack Start specifics:

  • Netlify guide shows the vite.config.ts swap from @netlify/vite-plugin-tanstack-startnitro/vite (diff-highlighted)
  • Vercel guide notes no vite.config.ts change is needed since Vercel already uses Nitro
  • Both guides surface the --entry .output/server/index.mjs flag in the deploy step

Summary by CodeRabbit

  • Documentation
    • Added a Migration guides section with step-by-step Vercel and Netlify migration guides for Prisma Compute
    • Updated TanStack Start quickstart with explicit multi-line deploy commands and required entry-point configuration
    • Expanded limitations and framework support docs with Next.js (pnpm) troubleshooting, Astro notes, and Nitro/TanStack deployment guidance

@vercel
Copy link
Copy Markdown

vercel Bot commented May 5, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
blog Ready Ready Preview, Comment May 5, 2026 4:06pm
docs Ready Ready Preview, Comment May 5, 2026 4:06pm
eclipse Ready Ready Preview, Comment May 5, 2026 4:06pm
site Ready Ready Preview, Comment May 5, 2026 4:06pm

Request Review

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 5, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 34dc1458-b48e-4f05-affa-fa4f142b279e

📥 Commits

Reviewing files that changed from the base of the PR and between 0e5b95c and d7b70be.

📒 Files selected for processing (4)
  • apps/docs/content/docs/compute-internal/guides/netlify.mdx
  • apps/docs/content/docs/compute-internal/guides/vercel.mdx
  • apps/docs/content/docs/compute/guides/netlify.mdx
  • apps/docs/content/docs/compute/guides/vercel.mdx
✅ Files skipped from review due to trivial changes (3)
  • apps/docs/content/docs/compute-internal/guides/netlify.mdx
  • apps/docs/content/docs/compute/guides/vercel.mdx
  • apps/docs/content/docs/compute/guides/netlify.mdx
🚧 Files skipped from review as they are similar to previous changes (1)
  • apps/docs/content/docs/compute-internal/guides/vercel.mdx

Walkthrough

Adds public and internal "Migration guides" (Vercel, Netlify) and metadata, plus related Compute docs updates (TanStack Start quickstart and Next.js pnpm troubleshooting) to support migrating Vercel/Netlify deployments to Prisma Compute.

Changes

Migration guides + navigation and supporting docs

Layer / File(s) Summary
Navigation / Section meta
apps/docs/content/docs/compute/meta.json, apps/docs/content/docs/compute-internal/meta.json, apps/docs/content/docs/compute/guides/meta.json, apps/docs/content/docs/compute-internal/guides/meta.json
Adds a "Migration guides" section to public and internal documentation navigation and creates meta.json files listing vercel and netlify.
Guide frontmatter / page creation
apps/docs/content/docs/compute/guides/vercel.mdx, apps/docs/content/docs/compute/guides/netlify.mdx, apps/docs/content/docs/compute-internal/guides/vercel.mdx, apps/docs/content/docs/compute-internal/guides/netlify.mdx
Adds new MDX pages (public and internal) for Vercel→Compute and Netlify→Compute migration guides with frontmatter and page metadata.
Guide content: prerequisites & prepare
apps/docs/content/docs/compute/guides/*.mdx, apps/docs/content/docs/compute-internal/guides/*.mdx
Adds prerequisites, framework-specific preparation instructions (Next.js standalone, Astro Node adapter, TanStack Start notes, Nuxt/Bun), and guidance to migrate platform-specific routing/functions/plugins into app code.
Guide content: local build & deploy
apps/docs/content/docs/compute/guides/*.mdx, apps/docs/content/docs/compute-internal/guides/*.mdx
Adds local build steps and CLI deploy examples (prisma / @prisma/cli@Preview), --http-port guidance (3000 vs 4321 for Astro), and examples for passing runtime envs.
Env var workflows & verification
apps/docs/content/docs/compute/guides/*.mdx, apps/docs/content/docs/compute-internal/guides/*.mdx
Documents exporting/pulling platform env vars (Vercel/Netlify CLIs), handling masked secrets, updating/listing env vars after deploy, verification steps, logs, and deployment inspection commands.
Supporting docs updates
apps/docs/content/docs/compute-internal/quickstart/tanstack-start.mdx, apps/docs/content/docs/compute-internal/limitations.mdx
Expands TanStack Start quickstart deploy examples to explicit multi-line flags (--entry / --entrypoint, --http-port 3000) and adds Next.js + pnpm troubleshooting note in limitations; updates TanStack Start entry/entrypoint wording.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'feat(docs): add Netlify and Vercel Compute migration guides' directly and accurately summarizes the main change—adding migration guides for both platforms.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

  • Generate code and open pull requests
  • Plan features and break down work
  • Investigate incidents and troubleshoot customer tickets together
  • Automate recurring tasks and respond to alerts with triggers
  • Summarize progress and report instantly

Built for teams:

  • Shared memory across your entire org—no repeating context
  • Per-thread sandboxes to safely plan and execute work
  • Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started


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

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 5, 2026

🍈 Lychee Link Check Report

26 links: ✅ 1 OK | 🚫 0 errors | 🔀 0 redirects | 👻 25 excluded

✅ All links are working!


Full Statistics Table
Status Count
✅ Successful 1
🔀 Redirected 0
👻 Excluded 25
🚫 Errors 0
⛔ Unsupported 0
⏳ Timeouts 0
❓ Unknown 0

@argos-ci
Copy link
Copy Markdown

argos-ci Bot commented May 5, 2026

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build Status Details Updated (UTC)
default (Inspect) ✅ No changes detected - May 5, 2026, 4:31 PM

Copy link
Copy Markdown
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: 6

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@apps/docs/content/docs/compute-internal/guides/netlify.mdx`:
- Around line 130-142: Add a clear, explicit warning inside the "Export Netlify
environment variables with the CLI" Accordion telling readers that the generated
.env.netlify file contains sensitive production secrets and must be kept local
only (do not commit), and instruct them to add .env.netlify to .gitignore; refer
to the Accordion title "Export Netlify environment variables with the CLI" and
mention the filename `.env.netlify` and `.gitignore` so maintainers can place
the note immediately after the netlify CLI example.

In `@apps/docs/content/docs/compute-internal/guides/vercel.mdx`:
- Around line 129-134: After the `vercel env pull .env.vercel
--environment=production` example in the Vercel guide, add a concise
secret-handling warning instructing readers that `.env.vercel` contains
production secrets, must not be committed to version control, and should be
securely deleted after migrating required values; update the paragraph near the
existing code block and reference `.env.vercel` and the surrounding Vercel env
pull example so the warning appears immediately after the shown command.
- Around line 87-90: Replace the unsafe deletion command "rm -rf .next
node_modules ~/package-lock.json" with a repo-local cleanup (e.g., remove "~/"
so it targets "./package-lock.json" or just ".next" and "node_modules") and add
a short note telling users to manually check and remove ~/package-lock.json only
if they confirm it is an accidental home-directory file; update the code block
that currently contains that command accordingly.

In `@apps/docs/content/docs/compute/guides/netlify.mdx`:
- Around line 130-135: Add an explicit secret-hygiene warning in the Netlify env
export example in apps/docs/content/docs/compute/guides/netlify.mdx: after the
bash block that shows `netlify env:list --context production --plain >
.env.netlify` insert a single-sentence caution that `.env.netlify` is sensitive,
must not be committed to version control, and should be deleted after copying
needed values (so readers know to treat the exported file as secrets and remove
it after migration).

In `@apps/docs/content/docs/compute/guides/vercel.mdx`:
- Around line 121-129: Add an explicit warning under the "Pull Vercel
environment variables with the CLI" Accordion that pulled files like
`.env.vercel` contain production secrets and must not be committed; instruct
readers to add `.env.vercel` to `.gitignore` and treat it as sensitive
local-only data, placed immediately after the `vercel env pull .env.vercel
--environment=production` example and before the paragraph that lists runtime
values like `DATABASE_URL`.
- Around line 67-72: Update the install/build instructions so they aren't
npm-specific: replace or augment the lines containing "npm install" and "npm run
build" with a generalized wording and add a brief note that projects using pnpm
or yarn should run the equivalent commands (e.g., pnpm install / pnpm build or
yarn install / yarn build) so the doc supports different package managers.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: f55b68d0-4fdd-4b37-8bad-fc893ac058ed

📥 Commits

Reviewing files that changed from the base of the PR and between f69b5c4 and 0e5b95c.

📒 Files selected for processing (10)
  • apps/docs/content/docs/compute-internal/guides/meta.json
  • apps/docs/content/docs/compute-internal/guides/netlify.mdx
  • apps/docs/content/docs/compute-internal/guides/vercel.mdx
  • apps/docs/content/docs/compute-internal/limitations.mdx
  • apps/docs/content/docs/compute-internal/meta.json
  • apps/docs/content/docs/compute-internal/quickstart/tanstack-start.mdx
  • apps/docs/content/docs/compute/guides/meta.json
  • apps/docs/content/docs/compute/guides/netlify.mdx
  • apps/docs/content/docs/compute/guides/vercel.mdx
  • apps/docs/content/docs/compute/meta.json

Comment thread apps/docs/content/docs/compute-internal/guides/netlify.mdx
Comment thread apps/docs/content/docs/compute-internal/guides/vercel.mdx
Comment thread apps/docs/content/docs/compute-internal/guides/vercel.mdx
Comment thread apps/docs/content/docs/compute/guides/netlify.mdx
Comment thread apps/docs/content/docs/compute/guides/vercel.mdx
Comment thread apps/docs/content/docs/compute/guides/vercel.mdx
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.

2 participants