Skip to content

Restore/prisma next getting started#8005

Closed
nurul3101 wants to merge 22 commits into
mainfrom
restore/prisma-next-getting-started
Closed

Restore/prisma next getting started#8005
nurul3101 wants to merge 22 commits into
mainfrom
restore/prisma-next-getting-started

Conversation

@nurul3101

@nurul3101 nurul3101 commented Jul 3, 2026

Copy link
Copy Markdown
Member

Summary by CodeRabbit

  • New Features

    • Added a new Early Access “Prisma Next” docs section with getting started, quickstart, CLI, migration, and database setup guides.
    • Added new docs for PostgreSQL and MongoDB setup, plus importing existing databases and adding Prisma Next to existing projects.
    • Added an Early Access banner and new navigation paths for Prisma Next content.
  • Bug Fixes

    • Improved docs navigation, version switching, and sidebar behavior so Prisma Next pages appear in the right places and links resolve correctly.

ankur-arch and others added 22 commits May 11, 2026 16:41
- Replace "not production ready" callouts with Early Access notes across the
  Prisma Next docs pages, the Prisma Next blog series, and the ORM / Console
  feature-maturity definitions. New messaging: Prisma Next is the next major
  version of Prisma ORM, in Early Access, expect changes, share feedback;
  Prisma 7 is GA, keep using it for production.
- Point the site nav "Docs" link to /docs/next and the nav + footer "ORM"
  links to /docs/orm/next so users land on Prisma Next.
- Rename the ORM Next intro sidebar entry from "What is Prisma Next?" to
  "Prisma Next" for parity with the Prisma ORM (Latest) docs.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Apply the approved callout wording across all Prisma Next docs pages: invite
users to try the cutting-edge next major version in Early Access and share
feedback, and point anyone who wants the current GA release to Prisma 7.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Early Access now means: ready to try out, cutting edge, and evolving with user
feedback, with an API surface that won't change drastically. Removes the
"prepared for significant breaking changes" framing.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…aning

Keeps the Early Access -> Preview -> GA ladder monotonic: Preview is now
described as close to stable, validate in staging, rather than "not
recommended in production."

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Redirect bare /docs to /docs/next so the docs land on Prisma Next by
  default. Keep the Prisma 7 (Latest) getting-started reachable at
  /docs/getting-started: repoint the getting-started version switcher's
  Latest target and the Getting Started tab there (bare "/" now redirects),
  and update the callouts' Prisma 7 links to /getting-started.
- Add spacing under the callout title so the heading no longer sits flush
  against the body (applies to all callouts via CalloutTitle).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Incorporate Ty's feedback on the Prisma Next getting-started docs:

- Remove the auto-redirect from bare /docs to /docs/next; the docs now
  land on Introduction to Prisma.
- Remove the "Docs version" dropdown on getting-started pages. Prisma Next
  lives inline in the getting-started sidebar as its own sections instead
  of a separate rooted version. The ORM version dropdown is unchanged.
- Restructure the getting-started sidebar into: Getting Started,
  Get started with Prisma Next, Prisma Next (Quickstart + Add to Existing
  Project), Prisma ORM, and Prisma Postgres.
- Add a Prisma Next entry to the Prisma Postgres > Quickstart dropdown; the
  page moves to /prisma-postgres/quickstart/prisma-next with a redirect
  from the old path.
- Add a non-forceful Prisma Next callout on Introduction to Prisma.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Bring back the Prisma Next getting-started work from
aman/prisma-next-getting-started that was overridden on main.

Conflicts resolved to keep both main and branch intent:
- docs/site layout: keep Compute nav plus /next paths and Early Access banner imports
- footer/site ORM link points to /docs/orm/next
- (index)/index.mdx keeps Compute section and adds Prisma Next note

Co-authored-by: Cursor <cursoragent@cursor.com>
Fix spellcheck CI failure from the restored Prisma Next ORM overview,
which uses "inspectable" and "arktype" (arktype-json extension).

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@vercel

vercel Bot commented Jul 3, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
blog Ready Ready Preview, Comment Jul 3, 2026 4:20pm
docs Building Building Preview, Comment Jul 3, 2026 4:20pm
eclipse Building Building Preview, Comment Jul 3, 2026 4:20pm
site Building Building Preview, Comment Jul 3, 2026 4:20pm

Request Review

@coderabbitai

coderabbitai Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: a40be4c6-c5ce-4b78-9312-b769a6dc5544

📥 Commits

Reviewing files that changed from the base of the PR and between d363363 and 2ce2792.

📒 Files selected for processing (58)
  • apps/blog/content/blog/data-migrations-in-prisma-next/index.mdx
  • apps/blog/content/blog/mongodb-without-compromise/index.mdx
  • apps/blog/content/blog/prisma-next-call-for-extension-authors/index.mdx
  • apps/blog/content/blog/the-next-evolution-of-prisma-orm/index.mdx
  • apps/docs/content/docs/(index)/index.mdx
  • apps/docs/content/docs/(index)/meta.json
  • apps/docs/content/docs/(index)/next/add-to-existing-project/meta.json
  • apps/docs/content/docs/(index)/next/add-to-existing-project/mongodb.mdx
  • apps/docs/content/docs/(index)/next/add-to-existing-project/postgresql.mdx
  • apps/docs/content/docs/(index)/next/getting-started.mdx
  • apps/docs/content/docs/(index)/next/index.mdx
  • apps/docs/content/docs/(index)/next/prisma-postgres/from-the-cli.mdx
  • apps/docs/content/docs/(index)/next/prisma-postgres/import-from-existing-database-mysql.mdx
  • apps/docs/content/docs/(index)/next/prisma-postgres/import-from-existing-database-postgresql.mdx
  • apps/docs/content/docs/(index)/next/prisma-postgres/meta.json
  • apps/docs/content/docs/(index)/next/quickstart/meta.json
  • apps/docs/content/docs/(index)/next/quickstart/mongodb.mdx
  • apps/docs/content/docs/(index)/next/quickstart/postgresql.mdx
  • apps/docs/content/docs/(index)/prisma-postgres/quickstart/meta.json
  • apps/docs/content/docs/(index)/prisma-postgres/quickstart/prisma-next.mdx
  • apps/docs/content/docs/cli/meta.json
  • apps/docs/content/docs/cli/next/configuration.mdx
  • apps/docs/content/docs/cli/next/contract-emit.mdx
  • apps/docs/content/docs/cli/next/contract-infer.mdx
  • apps/docs/content/docs/cli/next/db-init.mdx
  • apps/docs/content/docs/cli/next/db-schema.mdx
  • apps/docs/content/docs/cli/next/db-sign.mdx
  • apps/docs/content/docs/cli/next/db-update.mdx
  • apps/docs/content/docs/cli/next/db-verify.mdx
  • apps/docs/content/docs/cli/next/index.mdx
  • apps/docs/content/docs/cli/next/init.mdx
  • apps/docs/content/docs/cli/next/meta.json
  • apps/docs/content/docs/cli/next/migration-apply.mdx
  • apps/docs/content/docs/cli/next/migration-new.mdx
  • apps/docs/content/docs/cli/next/migration-plan.mdx
  • apps/docs/content/docs/cli/next/migration-ref.mdx
  • apps/docs/content/docs/cli/next/migration-show.mdx
  • apps/docs/content/docs/cli/next/migration-status.mdx
  • apps/docs/content/docs/console/more/feature-maturity.mdx
  • apps/docs/content/docs/orm/index.mdx
  • apps/docs/content/docs/orm/more/releases.mdx
  • apps/docs/content/docs/orm/next/index.mdx
  • apps/docs/content/docs/orm/next/meta.json
  • apps/docs/cspell.json
  • apps/docs/next.config.mjs
  • apps/docs/src/app/(docs)/(default)/layout.tsx
  • apps/docs/src/app/global.css
  • apps/docs/src/app/layout.tsx
  • apps/docs/src/components/layout/link-item.tsx
  • apps/docs/src/components/layout/notebook/page/client.tsx
  • apps/docs/src/components/sidebar-badge-provider.tsx
  • apps/docs/src/components/version-switcher.tsx
  • apps/docs/src/lib/layout.shared.tsx
  • apps/docs/src/lib/version.ts
  • apps/docs/src/lib/versioned-sidebar-tree.ts
  • apps/docs/src/mdx-components.tsx
  • apps/site/src/app/layout.tsx
  • packages/ui/src/data/footer.ts

Walkthrough

This PR introduces "Prisma Next" documentation across blog posts, docs site, and CLI reference pages, updates Early Access/Preview messaging, adds new docs navigation config and redirects, wires a docs Early Access banner with version-aware sidebar/navigation logic, and updates marketing site ORM links.

Changes

Prisma Next Early Access rollout

Layer / File(s) Summary
Blog post wording updates
apps/blog/content/blog/data-migrations-in-prisma-next/..., mongodb-without-compromise/..., prisma-next-call-for-extension-authors/..., the-next-evolution-of-prisma-orm/...
Closing guidance sentences reworded from "not production-ready" to Early Access / Prisma 7 GA framing.
Feature maturity and ORM positioning
apps/docs/content/docs/console/more/feature-maturity.mdx, apps/docs/content/docs/orm/index.mdx, apps/docs/content/docs/orm/more/releases.mdx
Reworded Early Access/Preview criteria and added a "Try Prisma Next" tip callout.
Docs navigation config, redirects, spellcheck
apps/docs/content/docs/(index)/meta.json, .../next/*/meta.json, apps/docs/content/docs/cli/meta.json, apps/docs/content/docs/cli/next/meta.json, apps/docs/content/docs/orm/next/meta.json, apps/docs/next.config.mjs, apps/docs/cspell.json
Adds Prisma Next sections into docs meta configs, new redirect rules, and cspell word list entries.
Prisma Next overview and getting started
apps/docs/content/docs/(index)/index.mdx, .../next/index.mdx, .../next/getting-started.mdx, apps/docs/content/docs/orm/next/index.mdx
Adds Prisma Next landing/getting-started pages and an ORM overview page with a homepage callout linking to them.
Quickstart and existing-project guides
.../next/quickstart/*.mdx, .../next/add-to-existing-project/*.mdx, .../next/prisma-postgres/*.mdx, .../prisma-postgres/quickstart/prisma-next.mdx
Adds full quickstart and existing-project adoption guides for PostgreSQL and MongoDB, including Prisma Postgres import flows.
CLI reference documentation
apps/docs/content/docs/cli/next/*.mdx
Adds reference pages for prisma-next CLI commands (init, contract, db, migration operations).
Docs app banner, version switcher, sidebar wiring
apps/docs/src/app/layout.tsx, apps/docs/src/app/global.css, apps/docs/src/app/(docs)/(default)/layout.tsx, apps/docs/src/components/version-switcher.tsx, apps/docs/src/lib/version.ts, apps/docs/src/lib/versioned-sidebar-tree.ts, apps/docs/src/components/layout/link-item.tsx, apps/docs/src/components/sidebar-badge-provider.tsx, apps/docs/src/components/layout/notebook/page/client.tsx, apps/docs/src/lib/layout.shared.tsx, apps/docs/src/mdx-components.tsx
Adds an animated Early Access banner and reworks version-switching, sidebar filtering, and badge visibility for Getting Started/CLI/ORM "next" routes.
Marketing site ORM navigation links
apps/site/src/app/layout.tsx, packages/ui/src/data/footer.ts
Updates Products menu, Docs link, and footer ORM link to point to /docs/orm/next.

Estimated code review effort: 4 (Complex) | ~60 minutes

Possibly related issues

Possibly related PRs

  • prisma/web#7923: Both PRs update Prisma Next Early Access messaging in the same blog posts.
  • prisma/web#7931: Both PRs modify the sidebar badge provider component for badge visibility logic.
  • prisma/web#7933: Both PRs modify docs version routing/navigation stack (version.ts, versioned-sidebar-tree.ts, next.config redirects).

Poem

A rabbit hops through docs anew,
Prisma Next peeks into view,
Banners glow, the sidebar bends,
Version paths now make new friends,
Early Access, hop hop, docs pipeline crew! 🐇

✨ Finishing Touches
⚔️ Resolve merge conflicts
  • Resolve merge conflict in branch restore/prisma-next-getting-started

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

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.

3 participants