Docs for v6.17.0 #7133
Docs for v6.17.0 #7133
Conversation
WalkthroughDocumentation updates across Prisma Config reference and Prisma Postgres guides. Changes
Sequence Diagram(s)sequenceDiagram
autonumber
actor User
participant Console as Prisma Console
participant Postgres as Prisma Postgres Instance
User->>Console: Open active Prisma Postgres instance
Console-->>User: Instance dashboard
User->>Console: Open "API Keys" tab
User->>Console: Create API key
Console-->>User: API key + direct connection string
User->>Postgres: Connect using connection string
Postgres-->>User: Connection established / errors
Estimated code review effort🎯 2 (Simple) | ⏱️ ~10 minutes Possibly related PRs
Suggested reviewers
Pre-merge checks and finishing touches✅ Passed checks (3 passed)
✨ Finishing touches🧪 Generate unit tests (beta)
📜 Recent review detailsConfiguration used: CodeRabbit UI Review profile: CHILL Plan: Pro 📒 Files selected for processing (2)
🚧 Files skipped from review as they are similar to previous changes (2)
⏰ 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)
Comment |
Dangerous URL checkNo absolute URLs to prisma.io/docs found. |
Redirect checkThis PR probably requires the following redirects to be added to static/_redirects:
|
Deploying docs with
|
| Latest commit: |
278c740
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://2c9c364a.docs-51g.pages.dev |
| Branch Preview URL: | https://docs-6-17-0.docs-51g.pages.dev |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 0
Caution
Some comments are outside the diff and can’t be posted inline due to platform limitations.
⚠️ Outside diff range comments (2)
content/250-postgres/300-database/650-direct-connections.mdx (1)
38-39: Mask secrets and disable copy for sample credentialsThe example shows realistic-looking USER/PASSWORD (incl. an
sk_-prefixed token). Avoid accidental leakage and copy-paste into production.-```bash -DATABASE_URL="postgres://2f9881cc7eef46f094ac913df34c1fb441502fe66cbe28cc48998d4e6b20336b:sk_QZ3u8fMPFfBzOID4ol-mV@db.prisma.io:5432/?sslmode=require" +```bash no-copy +DATABASE_URL="postgres://<USER>:<PASSWORD>@db.prisma.io:5432/?sslmode=require"+Note: Replace and with the credentials generated in the Prisma Console.
</blockquote></details> <details> <summary>content/100-getting-started/03-prisma-postgres/115-import-from-existing-database-mysql.mdx (1)</summary><blockquote> `184-185`: **Prisma datasource provider should be "postgresql" (not "postgres")** This will break schema parsing and generation. ```diff - provider = "postgres" + provider = "postgresql"
🧹 Nitpick comments (11)
content/200-orm/800-more/350-ai-tools/300-windsurf.mdx (1)
555-555: Clarify local-auth caveat consistently across sectionsGood addition. Consider mirroring the same parenthetical in the “Usage” list (Line 568) so readers who skip the workflows section still see it.
-1. Authenticate with the [Prisma Console](https://console.prisma.io) using the sign-in prompt, then select a target [workspace](/platform/about#workspace) +1. Authenticate with the [Prisma Console](https://console.prisma.io) using the sign-in prompt (not required for local Prisma Postgres workflows), then select a target [workspace](/platform/about#workspace)content/250-postgres/1100-integrations/500-vscode.mdx (1)
23-23: Fix double space typoMinor copy edit.
-- View, create and delete Prisma Postgres instances (local & remote) +- View, create and delete Prisma Postgres instances (local & remote)content/200-orm/800-more/350-ai-tools/200-tabnine.mdx (1)
485-485: Correct product name (“Windsurf” → “your editor”)This Tabnine page references Windsurf by mistake.
-Beyond managing your database instances, the Prisma VS Code extension embeds Prisma Studio directly in your editor, making it easy to perform create, update, and delete operations on your database right inside Windsurf. Follow these [easy steps](/postgres/database/prisma-studio/studio-in-vs-code) to get started. +Beyond managing your database instances, the Prisma VS Code extension embeds Prisma Studio directly in your editor, making it easy to perform create, update, and delete operations on your database right inside your editor. Follow these [easy steps](/postgres/database/prisma-studio/studio-in-vs-code) to get started.content/200-orm/800-more/350-ai-tools/100-cursor.mdx (1)
548-548: Correct product name (“Windsurf” → “your editor”)Copy-paste issue.
-Beyond managing your database instances, the Prisma VS Code extension embeds Prisma Studio directly in your editor, making it easy to perform create, update, and delete operations on your database right inside Windsurf. Follow these [easy steps](/postgres/database/prisma-studio/studio-in-vs-code) to get started. +Beyond managing your database instances, the Prisma VS Code extension embeds Prisma Studio directly in your editor, making it easy to perform create, update, and delete operations on your database right inside your editor. Follow these [easy steps](/postgres/database/prisma-studio/studio-in-vs-code) to get started.content/250-postgres/300-database/650-direct-connections.mdx (2)
21-23: Grammar: “an environment”Article agreement.
-1. Navigate to a environment with an active Prisma Postgres instance +1. Navigate to an environment with an active Prisma Postgres instance
165-165: Typo: “connet” → “connect”; also “editor” → “database”Clearer wording.
-You can now connet to your Prisma Postgres editor using your favorite PostgreSQL client, e.g. `psql` or a GUI like ... +You can now connect to your Prisma Postgres database using your favorite PostgreSQL client, e.g. `psql` or a GUI like ...content/100-getting-started/03-prisma-postgres/115-import-from-existing-database-mysql.mdx (1)
44-49: Grammar: “an environment”Same article issue as other pages.
-1. Navigate to a environment with an active Prisma Postgres instance +1. Navigate to an environment with an active Prisma Postgres instancecontent/250-postgres/100-introduction/200-getting-started.mdx (1)
57-62: Grammar + consistency: “an environment”; consider consistent naming for “direct connection (TCP)”
- Fix article.
- Optional: Align terminology (“direct connection” vs “direct TCP connection”) with the title of the reference page for consistency.
-1. Navigate to a environment with an active Prisma Postgres instance +1. Navigate to an environment with an active Prisma Postgres instanceOptional wording tweak elsewhere on the page:
- First mention: “direct connection (TCP)”
- Subsequent mentions: “direct connection”
content/200-orm/500-reference/325-prisma-config-reference.mdx (3)
62-65: Clarify experimental flags type to match intended usage.If flags are opt-in only, make members optional true-literals to reflect “present = enabled” and avoid implying they must always be set.
experimental: { - adapter: true; - externalTables: true; - studio: true; + adapter?: true; + externalTables?: true; + studio?: true; };Follow-up: the options table below lists these as boolean; consider aligning wording to “set to true to enable; omit otherwise.”
171-171: Trim stray space in property name.Minor formatting nit in table header cell.
-| `studio.adapter ` | `(env: Env) => Promise<SqlMigrationAwareDriverAdapterFactory>` | No | none | +| `studio.adapter` | `(env: Env) => Promise<SqlMigrationAwareDriverAdapterFactory>` | No | none |
392-392: Typo: duplicated word.Fix “how how” → “how you”.
-For example, assuming `schema.prisma` defines the `datasource`, here's how how need to place the migrations folder: +For example, assuming `schema.prisma` defines the `datasource`, here's how you need to place the migrations folder:
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (8)
content/100-getting-started/03-prisma-postgres/115-import-from-existing-database-mysql.mdx(1 hunks)content/200-orm/500-reference/325-prisma-config-reference.mdx(10 hunks)content/200-orm/800-more/350-ai-tools/100-cursor.mdx(1 hunks)content/200-orm/800-more/350-ai-tools/200-tabnine.mdx(1 hunks)content/200-orm/800-more/350-ai-tools/300-windsurf.mdx(1 hunks)content/250-postgres/100-introduction/200-getting-started.mdx(1 hunks)content/250-postgres/1100-integrations/500-vscode.mdx(1 hunks)content/250-postgres/300-database/650-direct-connections.mdx(1 hunks)
⏰ 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: runner / linkspector
- GitHub Check: Lost Pixel
🔇 Additional comments (14)
content/250-postgres/1100-integrations/500-vscode.mdx (1)
22-22: LGTM — helpful clarificationThe “not required for local Prisma Postgres workflows” note looks good.
content/200-orm/800-more/350-ai-tools/200-tabnine.mdx (1)
468-468: LGTM — consistent with other AI tool pagescontent/200-orm/800-more/350-ai-tools/100-cursor.mdx (1)
531-531: LGTM — matches the pattern across docscontent/250-postgres/300-database/650-direct-connections.mdx (1)
21-39: Confirm UI path covers credential generationThe new “Dashboard → Connect to your database” flow implies credentials are created/provisioned. Validate that users will reliably get USER/PASSWORD via this path, or add a sub-step/link that explicitly points to where to generate/view credentials.
content/200-orm/500-reference/325-prisma-config-reference.mdx (10)
15-16: Good spacing for list + code block rendering.Blank line ensures proper MDX list/fence nesting.
28-31: Trailing comma improves diffs and Prettier compliance.Consistent with trailingComma: "all".
34-36: Good spacing before the second list code block.Prevents rendering quirks.
48-51: Consistent trailing comma in example.Matches surrounding samples.
103-104: Clear recommendation bullets.Good, concise guidance with links.
122-124: Table header formatting reads cleanly.Consistent with other sections.
136-141: D1 adapter example: flag + trailing comma look correct.Matches rename note below.
178-182: Studio example: experimental flag placement is clear.Trailing comma keeps style consistent.
223-224: “Learn more” link is correct and scoped.Matches feature name casing with backticks.
281-282: Duplicate “Learn more” link mirrors earlier section.Keeps cross-references consistent.
There was a problem hiding this comment.
Actionable comments posted: 0
🧹 Nitpick comments (3)
content/250-postgres/100-introduction/250-overview.mdx (3)
14-14: Tighten phrasing and parallelism in “Schema migrations and queries” bullet.“ORM/database library” reads awkwardly; prefer “ORM or database library” and switch “via”→“with” for consistency with other bullets.
-- Schema migrations and queries (via [Prisma ORM](https://www.prisma.io/orm) or any other ORM/database library) +- Schema migrations and queries (with [Prisma ORM](https://www.prisma.io/orm) or any other ORM or database library)
18-21: Product naming: prefer “Prisma Console dashboard”.Use the full product name and sentence‑case “dashboard” for consistency across docs.
-You can view the following usage metrics in your Console Dashboard: +You can view the following usage metrics in the Prisma Console dashboard:
22-26: Make metric labels concise and style‑consistent (avoid “your”, redundant words).Also, consider matching exact UI labels if they differ.
- Cumulative usage over time - - Total count of requests - - Storage used per project in your workspace - - Operations used per day + - Total requests + - Storage used per project + - Operations per day - Databases per project
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (1)
content/250-postgres/100-introduction/250-overview.mdx(1 hunks)
⏰ 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). (4)
- GitHub Check: Check internal links
- GitHub Check: runner / linkspector
- GitHub Check: Lost Pixel
- GitHub Check: Cloudflare Pages
🔇 Additional comments (1)
content/250-postgres/100-introduction/250-overview.mdx (1)
16-16: Target verified — /postgres/database/local-development resolves to an existing page.content/250-postgres/300-database/550-local-development.mdx exists and is referenced from multiple docs; repo search shows no broken references.
There was a problem hiding this comment.
Actionable comments posted: 3
🧹 Nitpick comments (3)
content/200-orm/500-reference/325-prisma-config-reference.mdx (3)
353-355: Typo: “objedct” → “object”; tighten phrasing and code-formaturl.-- if you're using `"classic"`, you must specify a `datasource` objedct with a `url` +- if you're using `"classic"`, you must specify a `datasource` object with a `url`
343-364: Add minimal examples for both engine modes to reduce ambiguity.Concrete snippets here will prevent misconfiguration and cut support questions.
### `engine` Determines whether you want to configure the database connection details via the `datasource` or an `adapter`. | Property | Type | Required | Default | | -------- | ------------------- | -------- | ------- | | `engine` | `"classic" \| "js"` | No | none | Note that: - if you're using `"classic"`, you must specify a `datasource` object with a `url` - if you're using `"js"`, you must provide an `adapter` function + +Examples: + +```ts +// classic (connection string) +export default { + engine: "classic", + datasource: { url: process.env.DATABASE_URL! }, +}; +``` + +```ts +// js (driver adapter) +export default { + engine: "js", + async adapter() { + const { PrismaLibSQL } = await import("@prisma/adapter-libsql"); + const { createClient } = await import("@libsql/client"); + return new PrismaLibSQL(createClient({ url: process.env.LIBSQL_URL! })); + }, +}; +```
423-424: Grammar: duplicate “how” and missing “you”.-For example, assuming `schema.prisma` defines the `datasource`, here's how how need to place the migrations folder: +For example, assuming `schema.prisma` defines the `datasource`, here's how you need to place the migrations folder:
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (1)
content/200-orm/500-reference/325-prisma-config-reference.mdx(12 hunks)
⏰ 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: Lost Pixel
🔇 Additional comments (1)
content/200-orm/500-reference/325-prisma-config-reference.mdx (1)
112-113: LGTM on formatting and style changes.Trailing commas, bolded file recommendations, table header tweaks, and “Learn more” links improve consistency and readability.
Also applies to: 147-147, 189-189, 232-232, 290-290, 131-133, 15-15, 30-30, 35-35, 50-50, 70-70, 94-94
There was a problem hiding this comment.
Actionable comments posted: 0
🧹 Nitpick comments (1)
content/250-postgres/100-introduction/200-getting-started.mdx (1)
56-61: Align wording with the new connection terminology.We renamed this flow to “direct connection string,” but Line 56 still says “direct TCP connection string.” Please drop “TCP” here (and anywhere else nearby) so the terminology is consistent with the rest of the doc.
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (3)
content/200-orm/500-reference/325-prisma-config-reference.mdx(4 hunks)content/250-postgres/100-introduction/200-getting-started.mdx(1 hunks)content/250-postgres/300-database/650-direct-connections.mdx(1 hunks)
🚧 Files skipped from review as they are similar to previous changes (2)
- content/250-postgres/300-database/650-direct-connections.mdx
- content/200-orm/500-reference/325-prisma-config-reference.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: runner / linkspector
- GitHub Check: Lost Pixel
Summary by CodeRabbit