From 1c8bd8251f2f406626012e0438bcc0d666c67189 Mon Sep 17 00:00:00 2001 From: Marc Hess Date: Mon, 27 Apr 2026 13:57:28 -0400 Subject: [PATCH 01/52] fix docs migration redirects and restore key SEO pages --- .../content/docs/(index)/getting-started.mdx | 46 ++++++ apps/docs/content/docs/(index)/meta.json | 1 + .../docs/accelerate/more/troubleshoot.mdx | 2 +- .../docs/guides/upgrade-prisma-orm/v6.mdx | 4 +- apps/docs/content/docs/orm/index.mdx | 4 +- .../more/comparisons/prisma-and-drizzle.mdx | 2 +- .../more/comparisons/prisma-and-mongoose.mdx | 2 +- .../more/comparisons/prisma-and-sequelize.mdx | 2 +- .../more/comparisons/prisma-and-typeorm.mdx | 6 +- .../content/docs/orm/prisma-client/index.mdx | 67 ++++++++ .../content/docs/orm/prisma-client/meta.json | 1 + .../docs/orm/prisma-client/queries/crud.mdx | 4 +- .../queries/excluding-fields.mdx | 45 ++++++ .../queries/filtering-and-sorting.mdx | 108 +++++++++++++ .../queries/full-text-search.mdx | 60 ++++++++ .../docs/orm/prisma-client/queries/meta.json | 9 +- .../orm/prisma-client/queries/pagination.mdx | 60 ++++++++ .../prisma-client/queries/select-fields.mdx | 66 ++++++++ .../generating-prisma-client.mdx | 58 +++++++ .../setup-and-configuration/meta.json | 1 + .../working-with-geometry-fields.mdx | 2 +- ...inst-partial-structures-of-model-types.mdx | 4 +- .../client-preview-features.mdx | 8 +- .../orm/reference/prisma-client-reference.mdx | 32 ++-- .../content/docs/postgres/error-reference.mdx | 2 +- apps/docs/package.json | 2 + apps/docs/scripts/audit-redirects.mjs | 145 ++++++++++++++++++ apps/docs/vercel.json | 67 ++------ 28 files changed, 716 insertions(+), 94 deletions(-) create mode 100644 apps/docs/content/docs/(index)/getting-started.mdx create mode 100644 apps/docs/content/docs/orm/prisma-client/index.mdx create mode 100644 apps/docs/content/docs/orm/prisma-client/queries/excluding-fields.mdx create mode 100644 apps/docs/content/docs/orm/prisma-client/queries/filtering-and-sorting.mdx create mode 100644 apps/docs/content/docs/orm/prisma-client/queries/full-text-search.mdx create mode 100644 apps/docs/content/docs/orm/prisma-client/queries/pagination.mdx create mode 100644 apps/docs/content/docs/orm/prisma-client/queries/select-fields.mdx create mode 100644 apps/docs/content/docs/orm/prisma-client/setup-and-configuration/generating-prisma-client.mdx create mode 100644 apps/docs/scripts/audit-redirects.mjs diff --git a/apps/docs/content/docs/(index)/getting-started.mdx b/apps/docs/content/docs/(index)/getting-started.mdx new file mode 100644 index 0000000000..f00dfa14e6 --- /dev/null +++ b/apps/docs/content/docs/(index)/getting-started.mdx @@ -0,0 +1,46 @@ +--- +title: Getting started +description: Choose the fastest path to start using Prisma ORM or Prisma Postgres in a new or existing project. +url: /getting-started +metaTitle: Prisma getting started +metaDescription: Choose a Prisma quickstart for new or existing projects and get from schema to first query quickly. +--- + +Prisma gives you a few good starting points depending on whether you need a database, already have one, or want the smallest possible local setup. + +## Choose your path + +### Start a new project + +- [Quickstart with Prisma Postgres](/prisma-orm/quickstart/prisma-postgres) for the fastest end-to-end path with a managed PostgreSQL database +- [Quickstart with PostgreSQL](/prisma-orm/quickstart/postgresql) if you want to work with PostgreSQL +- [Quickstart with SQLite](/prisma-orm/quickstart/sqlite) for a lightweight local setup +- [Quickstart with MySQL](/prisma-orm/quickstart/mysql) if your application uses MySQL +- [Quickstart with MongoDB](/prisma-orm/quickstart/mongodb) if your application uses MongoDB + +### Add Prisma to an existing project + +- [Add Prisma ORM to an existing PostgreSQL project](/prisma-orm/add-to-existing-project/postgresql) +- [Add Prisma ORM to an existing MySQL project](/prisma-orm/add-to-existing-project/mysql) +- [Add Prisma ORM to an existing SQLite project](/prisma-orm/add-to-existing-project/sqlite) +- [Add Prisma ORM to an existing MongoDB project](/prisma-orm/add-to-existing-project/mongodb) +- [Add Prisma ORM to an existing Prisma Postgres project](/prisma-orm/add-to-existing-project/prisma-postgres) + +## What you will do + +No matter which guide you choose, the flow is usually the same: + +1. Define a database connection and data model in your [Prisma schema](/orm/prisma-schema/overview). +2. Install Prisma CLI and [Prisma Client](/orm/prisma-client). +3. Run `prisma generate` to create a type-safe client for your schema. +4. Create or introspect your database, then start sending queries from your application. + +## Next steps + +After setup, these pages are usually the next ones people need: + +- [Prisma Client overview](/orm/prisma-client) +- [Generating Prisma Client](/orm/prisma-client/setup-and-configuration/generating-prisma-client) +- [Prisma Migrate getting started](/orm/prisma-migrate/getting-started) +- [Prisma schema overview](/orm/prisma-schema/overview) + diff --git a/apps/docs/content/docs/(index)/meta.json b/apps/docs/content/docs/(index)/meta.json index 50cf00db51..878f912fea 100644 --- a/apps/docs/content/docs/(index)/meta.json +++ b/apps/docs/content/docs/(index)/meta.json @@ -4,6 +4,7 @@ "pages": [ "---Getting Started---", "index", + "getting-started", "---Prisma ORM---", "...prisma-orm", "---Prisma Postgres---", diff --git a/apps/docs/content/docs/accelerate/more/troubleshoot.mdx b/apps/docs/content/docs/accelerate/more/troubleshoot.mdx index d7b25e4ed9..e3125a12ac 100644 --- a/apps/docs/content/docs/accelerate/more/troubleshoot.mdx +++ b/apps/docs/content/docs/accelerate/more/troubleshoot.mdx @@ -24,7 +24,7 @@ This error may arise if images or files stored within your table are being fetch In certain cases, a large number of records or fields are unintentionally fetched, which results in exceeding the configured query response size limit. This could happen when the [`where`](/orm/reference/prisma-client-reference#where) clause in the query is incorrect or entirely missing. -**Suggested solution:** Configure the query response size limit to be larger. If the limit is still exceeded, double-check that the `where` clause is filtering data as expected. To prevent fetching too many records, consider using [pagination](/v6/orm/prisma-client/queries/pagination). Additionally, use the [`select`](/orm/reference/prisma-client-reference#select) clause to return only the necessary fields, reducing the response size. +**Suggested solution:** Configure the query response size limit to be larger. If the limit is still exceeded, double-check that the `where` clause is filtering data as expected. To prevent fetching too many records, consider using [pagination](/orm/prisma-client/queries/pagination). Additionally, use the [`select`](/orm/reference/prisma-client-reference#select) clause to return only the necessary fields, reducing the response size. #### Fetching a large volume of data diff --git a/apps/docs/content/docs/guides/upgrade-prisma-orm/v6.mdx b/apps/docs/content/docs/guides/upgrade-prisma-orm/v6.mdx index 01c436ac52..ab024d3dbb 100644 --- a/apps/docs/content/docs/guides/upgrade-prisma-orm/v6.mdx +++ b/apps/docs/content/docs/guides/upgrade-prisma-orm/v6.mdx @@ -153,7 +153,7 @@ That way, you have a single, dedicated migration that takes care of this schema ### Full-text search on PostgreSQL -The [`fullTextSearch`](/v6/orm/prisma-client/queries/full-text-search) Preview feature is promoted to General Availability only for MySQL. This means that if you're using PostgreSQL and currently make use of this Preview feature, you now need to use the new [`fullTextSearchPostgres`](/v6/orm/prisma-client/queries/full-text-search#enabling-full-text-search-for-postgresql) Preview feature: +The [`fullTextSearch`](/orm/prisma-client/queries/full-text-search) Preview feature is promoted to General Availability only for MySQL. This means that if you're using PostgreSQL and currently make use of this Preview feature, you now need to use the new [`fullTextSearchPostgres`](/orm/prisma-client/queries/full-text-search#enabling-full-text-search-for-postgresql) Preview feature: #### Before @@ -355,7 +355,7 @@ generator client { ### `fullTextSearch` -If you use the [full-text search](/v6/orm/prisma-client/queries/full-text-search) feature with **MySQL** in your app, you can now remove `fullTextSearch` from the `previewFeatures` in your Prisma schema: +If you use the [full-text search](/orm/prisma-client/queries/full-text-search) feature with **MySQL** in your app, you can now remove `fullTextSearch` from the `previewFeatures` in your Prisma schema: ```prisma generator client { diff --git a/apps/docs/content/docs/orm/index.mdx b/apps/docs/content/docs/orm/index.mdx index 9ec833cb03..1801a953ca 100644 --- a/apps/docs/content/docs/orm/index.mdx +++ b/apps/docs/content/docs/orm/index.mdx @@ -8,7 +8,7 @@ metaDescription: This page gives a high-level overview of what Prisma ORM is and Prisma ORM is [open-source](https://github.com/prisma/prisma) and consists of: -- [**Prisma Client**](/orm/prisma-client/setup-and-configuration/introduction): Auto-generated, type-safe **ORM interface** +- [**Prisma Client**](/orm/prisma-client): Auto-generated, type-safe **ORM interface** - [**Prisma Migrate**](/orm/prisma-migrate): Database migration system - [**Prisma Studio**](https://www.prisma.io/studio): GUI to view and edit your data @@ -137,4 +137,4 @@ const user = await prisma.user.create({ ## Next steps - [**Prisma schema**](/orm/prisma-schema/overview) - Learn the schema language -- [**Prisma Client**](/orm/prisma-client/setup-and-configuration/introduction) - Explore the query API +- [**Prisma Client**](/orm/prisma-client) - Explore the query API diff --git a/apps/docs/content/docs/orm/more/comparisons/prisma-and-drizzle.mdx b/apps/docs/content/docs/orm/more/comparisons/prisma-and-drizzle.mdx index e68a20c950..0150978907 100644 --- a/apps/docs/content/docs/orm/more/comparisons/prisma-and-drizzle.mdx +++ b/apps/docs/content/docs/orm/more/comparisons/prisma-and-drizzle.mdx @@ -210,7 +210,7 @@ const posts = await db.query.posts.findMany({ ### Filtering -Drizzle exposes the underlying filter and conditional operators for a given SQL dialect. Prisma ORM on the other hand, provides a more [generic set of operators](/v6/orm/prisma-client/queries/filtering-and-sorting#combining-operators) that are intuitive to use. +Drizzle exposes the underlying filter and conditional operators for a given SQL dialect. Prisma ORM on the other hand, provides a more [generic set of operators](/orm/prisma-client/queries/filtering-and-sorting#combining-operators) that are intuitive to use. A good example of how the filtering APIs of both Drizzle and Prisma ORM differ is by looking at `string` filters. While Drizzle provides filters for `like` and `ilike`, Prisma ORM provides more specific operators that developers can use, e.g.: `contains`, `startsWith` and `endsWith`. diff --git a/apps/docs/content/docs/orm/more/comparisons/prisma-and-mongoose.mdx b/apps/docs/content/docs/orm/more/comparisons/prisma-and-mongoose.mdx index 88beabe37d..e0d2e2f81f 100644 --- a/apps/docs/content/docs/orm/more/comparisons/prisma-and-mongoose.mdx +++ b/apps/docs/content/docs/orm/more/comparisons/prisma-and-mongoose.mdx @@ -104,7 +104,7 @@ const posts = await Post.find({ **Prisma ORM** -Prisma ORM generates many [additional filters](/v6/orm/prisma-client/queries/filtering-and-sorting) that are commonly used in modern application development. +Prisma ORM generates many [additional filters](/orm/prisma-client/queries/filtering-and-sorting) that are commonly used in modern application development. **Mongoose** diff --git a/apps/docs/content/docs/orm/more/comparisons/prisma-and-sequelize.mdx b/apps/docs/content/docs/orm/more/comparisons/prisma-and-sequelize.mdx index d8aef4c764..6e421edf46 100644 --- a/apps/docs/content/docs/orm/more/comparisons/prisma-and-sequelize.mdx +++ b/apps/docs/content/docs/orm/more/comparisons/prisma-and-sequelize.mdx @@ -141,7 +141,7 @@ const post = await Post.findAll({ **Prisma ORM** -Prisma ORM generates many [additional filters](/v6/orm/prisma-client/queries/filtering-and-sorting) that are commonly used in modern application development. +Prisma ORM generates many [additional filters](/orm/prisma-client/queries/filtering-and-sorting) that are commonly used in modern application development. **Sequelize** diff --git a/apps/docs/content/docs/orm/more/comparisons/prisma-and-typeorm.mdx b/apps/docs/content/docs/orm/more/comparisons/prisma-and-typeorm.mdx index 6d74fb7176..350b240a36 100644 --- a/apps/docs/content/docs/orm/more/comparisons/prisma-and-typeorm.mdx +++ b/apps/docs/content/docs/orm/more/comparisons/prisma-and-typeorm.mdx @@ -28,7 +28,7 @@ The following sections examine a few examples for how Prisma ORM's and TypeORM's ### Filtering -TypeORM primarily leans on SQL operators for filtering lists or records, e.g. with the `find` method. Prisma ORM on the other hand, provides a more [generic set of operators](/v6/orm/prisma-client/queries/filtering-and-sorting#combining-operators) that are intuitive to use. It should also be noted that, as explained in the type-safety section [below](#filtering-1), TypeORM loses type-safety in filter queries in many scenarios. +TypeORM primarily leans on SQL operators for filtering lists or records, e.g. with the `find` method. Prisma ORM on the other hand, provides a more [generic set of operators](/orm/prisma-client/queries/filtering-and-sorting#combining-operators) that are intuitive to use. It should also be noted that, as explained in the type-safety section [below](#filtering-1), TypeORM loses type-safety in filter queries in many scenarios. A good example of how the filtering APIs of both TypeORM and Prisma ORM differ is by looking at `string` filters. While TypeORM primarily provides the filter based on the `ILike` operator which comes directly from SQL, Prisma ORM provides more specific operators that developers can use, e.g.: `contains`, `startsWith` and `endsWith`. @@ -98,7 +98,7 @@ const posts = await postRepository.find({ ### Pagination -TypeORM only offers limit-offset pagination while Prisma ORM conveniently provides dedicated APIs for both limit-offset but also cursor-based. You can learn more about both approaches in the [Pagination](/v6/orm/prisma-client/queries/pagination) section of the docs or in the API comparison [below](#pagination-1). +TypeORM only offers limit-offset pagination while Prisma ORM conveniently provides dedicated APIs for both limit-offset but also cursor-based. You can learn more about both approaches in the [Pagination](/orm/prisma-client/queries/pagination) section of the docs or in the API comparison [below](#pagination-1). ### Relations @@ -781,7 +781,7 @@ const users = await userRepository.find({ **Prisma ORM** -Prisma ORM generates many [additional filters](/v6/orm/prisma-client/queries/filtering-and-sorting) that are commonly used in modern application development. +Prisma ORM generates many [additional filters](/orm/prisma-client/queries/filtering-and-sorting) that are commonly used in modern application development. **TypeORM** diff --git a/apps/docs/content/docs/orm/prisma-client/index.mdx b/apps/docs/content/docs/orm/prisma-client/index.mdx new file mode 100644 index 0000000000..e21ca28e6c --- /dev/null +++ b/apps/docs/content/docs/orm/prisma-client/index.mdx @@ -0,0 +1,67 @@ +--- +title: Prisma Client +description: Prisma Client is Prisma ORM's generated, type-safe query builder for Node.js, Bun, and Deno applications. +url: /orm/prisma-client +metaTitle: Prisma Client overview +metaDescription: Learn what Prisma Client is, how to generate it, and where to go next for querying, relations, and transactions. +--- + +Prisma Client is Prisma ORM's generated query builder. It is tailored to your schema, fully typed, and designed to make common database work feel like ordinary application code. + +## What Prisma Client gives you + +- Typed query methods based on your models +- Autocomplete for filters, relations, ordering, and nested writes +- Predictable plain JavaScript objects as query results +- A single client API that works across PostgreSQL, MySQL, SQLite, MongoDB, and more + +## Quick start + +### 1. Define a generator in your schema + +```prisma title="schema.prisma" +generator client { + provider = "prisma-client" + output = "./generated" +} +``` + +### 2. Install Prisma Client + +```npm +npm install @prisma/client +``` + +### 3. Generate the client + +```npm +npx prisma generate +``` + +If you want more detail on this step, see [Generating Prisma Client](/orm/prisma-client/setup-and-configuration/generating-prisma-client). + +### 4. Import and use the generated client + +```ts +import { PrismaClient } from "./generated/client"; + +const prisma = new PrismaClient(); + +const users = await prisma.user.findMany(); +``` + +## Common tasks + +- [Set up and configure Prisma Client](/orm/prisma-client/setup-and-configuration/introduction) +- [Generate Prisma Client](/orm/prisma-client/setup-and-configuration/generating-prisma-client) +- [Run CRUD queries](/orm/prisma-client/queries/crud) +- [Work with relations](/orm/prisma-client/queries/relation-queries) +- [Use transactions](/orm/prisma-client/queries/transactions) +- [Use raw SQL when you need it](/orm/prisma-client/using-raw-sql) + +## Related reference docs + +- [Prisma Client API reference](/orm/reference/prisma-client-reference) +- [Prisma schema generators](/orm/prisma-schema/overview/generators) +- [Prisma CLI generate command](/cli/generate) + diff --git a/apps/docs/content/docs/orm/prisma-client/meta.json b/apps/docs/content/docs/orm/prisma-client/meta.json index 5ec7a0aa33..59b0fa959d 100644 --- a/apps/docs/content/docs/orm/prisma-client/meta.json +++ b/apps/docs/content/docs/orm/prisma-client/meta.json @@ -2,6 +2,7 @@ "title": "Prisma Client", "defaultOpen": true, "pages": [ + "index", "setup-and-configuration", "queries", "client-extensions", diff --git a/apps/docs/content/docs/orm/prisma-client/queries/crud.mdx b/apps/docs/content/docs/orm/prisma-client/queries/crud.mdx index 3c5fde2791..7ec37cbbe9 100644 --- a/apps/docs/content/docs/orm/prisma-client/queries/crud.mdx +++ b/apps/docs/content/docs/orm/prisma-client/queries/crud.mdx @@ -129,7 +129,7 @@ const nearbyLocations = await prisma.location.findMany({ }); ``` -See [Filtering and sorting](/v6/orm/prisma-client/queries/filtering-and-sorting) for more examples, or [Working with geometry fields](/orm/prisma-client/special-fields-and-types/working-with-geometry-fields) for spatial queries. +See [Filtering and sorting](/orm/prisma-client/queries/filtering-and-sorting) for more examples, or [Working with geometry fields](/orm/prisma-client/special-fields-and-types/working-with-geometry-fields) for spatial queries. ### Select fields @@ -150,7 +150,7 @@ const users = await prisma.user.findMany({ }); ``` -See [Select fields](/v6/orm/prisma-client/queries/select-fields) and [Relation queries](/orm/prisma-client/queries/relation-queries) for more. +See [Select fields](/orm/prisma-client/queries/select-fields) and [Relation queries](/orm/prisma-client/queries/relation-queries) for more. ## Update diff --git a/apps/docs/content/docs/orm/prisma-client/queries/excluding-fields.mdx b/apps/docs/content/docs/orm/prisma-client/queries/excluding-fields.mdx new file mode 100644 index 0000000000..6c92c66273 --- /dev/null +++ b/apps/docs/content/docs/orm/prisma-client/queries/excluding-fields.mdx @@ -0,0 +1,45 @@ +--- +title: Excluding fields +description: Learn how to exclude fields from Prisma Client results with the omit option. +url: /orm/prisma-client/queries/excluding-fields +metaTitle: Excluding fields +metaDescription: Learn how to use omit in Prisma Client to exclude fields globally or per query. +--- + +Use `omit` when you want Prisma Client to return the normal result shape except for a few specific fields. + +## Omit a field for one query + +```ts +const user = await prisma.user.findUnique({ + where: { id: 1 }, + omit: { + password: true, + }, +}); +``` + +## Omit fields globally + +You can also configure `omit` on the client itself: + +```ts +const prisma = new PrismaClient({ + omit: { + user: { + password: true, + }, + }, +}); +``` + +## When to use omit vs select + +- Use [`select`](/orm/prisma-client/queries/select-fields) when you want to return only a small subset of fields. +- Use `omit` when the default result is mostly correct and you only want to remove a few sensitive or noisy fields. + +## Related pages + +- [Select fields](/orm/prisma-client/queries/select-fields) +- [Prisma Client API reference](/orm/reference/prisma-client-reference#omit) + diff --git a/apps/docs/content/docs/orm/prisma-client/queries/filtering-and-sorting.mdx b/apps/docs/content/docs/orm/prisma-client/queries/filtering-and-sorting.mdx new file mode 100644 index 0000000000..2a6e55637f --- /dev/null +++ b/apps/docs/content/docs/orm/prisma-client/queries/filtering-and-sorting.mdx @@ -0,0 +1,108 @@ +--- +title: Filtering and sorting +description: Learn how to filter Prisma Client queries with where and sort results with orderBy. +url: /orm/prisma-client/queries/filtering-and-sorting +metaTitle: Filtering and sorting +metaDescription: Learn how to filter Prisma Client results with where, combine operators, use relation filters, and sort with orderBy. +--- + +Prisma Client lets you narrow results with `where` and order them with `orderBy`. + +## Filtering with where + +Use `where` to match records by field values: + +```ts +const users = await prisma.user.findMany({ + where: { + email: { + endsWith: "prisma.io", + }, + }, +}); +``` + +## Combining operators + +You can compose filters with operators such as `OR`, `AND`, and `NOT`: + +```ts +const users = await prisma.user.findMany({ + where: { + OR: [ + { email: { endsWith: "gmail.com" } }, + { email: { endsWith: "company.com" } }, + ], + NOT: { + email: { + endsWith: "admin.company.com", + }, + }, + }, +}); +``` + +## Filter on related records + +Relation filters let you match records based on related data: + +```ts +const users = await prisma.user.findMany({ + where: { + posts: { + some: { + published: true, + }, + }, + }, +}); +``` + +For more relation-specific patterns, see [Relation queries](/orm/prisma-client/queries/relation-queries). + +## Sort results with orderBy + +Use `orderBy` to control result ordering: + +```ts +const posts = await prisma.post.findMany({ + orderBy: { + title: "asc", + }, +}); +``` + +You can also combine filtering and sorting: + +```ts +const posts = await prisma.post.findMany({ + where: { + published: true, + }, + orderBy: { + createdAt: "desc", + }, +}); +``` + +## Case-insensitive filtering + +Case sensitivity depends on your database provider and collation settings. For PostgreSQL, Prisma Client also supports specific case-insensitive filter modes on supported operators. See the [Prisma Client API reference](/orm/reference/prisma-client-reference#mode) for details. + +## Sort by relation + +You can sort by properties on related records when the query shape supports it. For example, you might order posts by their author's name or users by related aggregates. + +## Sort by relevance (PostgreSQL and MySQL) + +On supported databases, Prisma Client can sort search results by relevance using `_relevance`. This is especially useful when combined with [full-text search](/orm/prisma-client/queries/full-text-search). + +## Sort with null records first or last + +Prisma Client supports explicit null ordering on supported databases so you can keep incomplete values grouped at the beginning or end of a result set. + +## Related pages + +- [Pagination](/orm/prisma-client/queries/pagination) +- [Select fields](/orm/prisma-client/queries/select-fields) +- [Prisma Client API reference](/orm/reference/prisma-client-reference#filter-conditions-and-operators) diff --git a/apps/docs/content/docs/orm/prisma-client/queries/full-text-search.mdx b/apps/docs/content/docs/orm/prisma-client/queries/full-text-search.mdx new file mode 100644 index 0000000000..d5e83d8a73 --- /dev/null +++ b/apps/docs/content/docs/orm/prisma-client/queries/full-text-search.mdx @@ -0,0 +1,60 @@ +--- +title: Full-text search +description: Learn how to search text fields with Prisma Client using your database's native full-text search support. +badge: preview +url: /orm/prisma-client/queries/full-text-search +metaTitle: Full-text search +metaDescription: Learn how to use full-text search with Prisma Client for PostgreSQL and MySQL. +--- + +Prisma Client supports full-text search for MySQL and for PostgreSQL with the `fullTextSearchPostgres` preview feature. + +## Enabling full-text search for PostgreSQL + +Add the preview flag to your generator and re-generate Prisma Client: + +```prisma title="schema.prisma" +generator client { + provider = "prisma-client" + output = "./generated" + previewFeatures = ["fullTextSearchPostgres"] +} +``` + +```npm +npx prisma generate +``` + +## Search within a text field + +```ts +const posts = await prisma.post.findMany({ + where: { + body: { + search: "cat | dog", + }, + }, +}); +``` + +## Sort by relevance + +Prisma Client also supports relevance-based ordering on supported databases: + +```ts +const posts = await prisma.post.findMany({ + orderBy: { + _relevance: { + fields: ["title"], + search: "database", + sort: "desc", + }, + }, +}); +``` + +## Related pages + +- [Filtering and sorting](/orm/prisma-client/queries/filtering-and-sorting) +- [Prisma Client API reference](/orm/reference/prisma-client-reference#search) +- [Preview features](/orm/reference/preview-features/client-preview-features) diff --git a/apps/docs/content/docs/orm/prisma-client/queries/meta.json b/apps/docs/content/docs/orm/prisma-client/queries/meta.json index 659547c90c..cdbca2dc1b 100644 --- a/apps/docs/content/docs/orm/prisma-client/queries/meta.json +++ b/apps/docs/content/docs/orm/prisma-client/queries/meta.json @@ -2,11 +2,14 @@ "title": "Queries", "pages": [ "crud", + "select-fields", + "excluding-fields", "relation-queries", - "transactions", - "field-selection", - "filtering", + "filtering-and-sorting", + "pagination", "aggregation-grouping-summarizing", + "transactions", + "full-text-search", "advanced" ] } diff --git a/apps/docs/content/docs/orm/prisma-client/queries/pagination.mdx b/apps/docs/content/docs/orm/prisma-client/queries/pagination.mdx new file mode 100644 index 0000000000..8c144e1d26 --- /dev/null +++ b/apps/docs/content/docs/orm/prisma-client/queries/pagination.mdx @@ -0,0 +1,60 @@ +--- +title: Pagination +description: Learn how to paginate Prisma Client query results with offset pagination and cursor-based pagination. +url: /orm/prisma-client/queries/pagination +metaTitle: Pagination +metaDescription: Learn how to use offset pagination and cursor-based pagination with Prisma Client. +--- + +Prisma Client supports both offset pagination and cursor-based pagination. + +## Offset pagination + +Use `skip` and `take` when you need page numbers or shallow navigation through a result set: + +```ts +const posts = await prisma.post.findMany({ + skip: 20, + take: 10, +}); +``` + +Offset pagination is straightforward, but it becomes more expensive as the offset grows. + +## Cursor-based pagination + +Use `cursor` and `take` when you want stable, scalable pagination for feeds, timelines, or large datasets: + +```ts +const firstPage = await prisma.post.findMany({ + take: 10, + orderBy: { + id: "asc", + }, +}); + +const lastPost = firstPage[firstPage.length - 1]; + +const nextPage = await prisma.post.findMany({ + take: 10, + skip: 1, + cursor: { + id: lastPost.id, + }, + orderBy: { + id: "asc", + }, +}); +``` + +## Which approach to choose + +- Use offset pagination when users need to jump directly to a numbered page. +- Use cursor-based pagination when you care more about performance and consistency as the dataset grows. + +## Related pages + +- [Filtering and sorting](/orm/prisma-client/queries/filtering-and-sorting) +- [Query Insights](/query-insights) +- [Prisma Client API reference](/orm/reference/prisma-client-reference#cursor) + diff --git a/apps/docs/content/docs/orm/prisma-client/queries/select-fields.mdx b/apps/docs/content/docs/orm/prisma-client/queries/select-fields.mdx new file mode 100644 index 0000000000..1db2dc8ab3 --- /dev/null +++ b/apps/docs/content/docs/orm/prisma-client/queries/select-fields.mdx @@ -0,0 +1,66 @@ +--- +title: Select fields +description: Learn how to return only the fields and relations you need with select and include in Prisma Client. +url: /orm/prisma-client/queries/select-fields +metaTitle: Select fields +metaDescription: Learn how to use select and include in Prisma Client to return only the fields and relations you need. +--- + +By default, Prisma Client returns all scalar fields for a model and no relations. Use `select` and `include` to make the result smaller, clearer, and more intentional. + +## Return the default fields + +If you do not pass `select`, `include`, or `omit`, Prisma Client returns all scalar fields for the model and excludes relations from the result. + +## Select specific fields + +Use `select` when you only need a few scalar fields: + +```ts +const user = await prisma.user.findFirst({ + select: { + email: true, + name: true, + }, +}); +``` + +## Return nested objects by selecting relation fields + +Use `include` when you want related records alongside the main result: + +```ts +const user = await prisma.user.findFirst({ + include: { + posts: true, + }, +}); +``` + +## Nest selections + +You can combine both patterns to keep relation payloads focused: + +```ts +const user = await prisma.user.findFirst({ + select: { + email: true, + posts: { + select: { + title: true, + published: true, + }, + }, + }, +}); +``` + +## Omit fields instead of selecting everything manually + +If you mostly want the default result but need to exclude a few fields, see [Excluding fields](/orm/prisma-client/queries/excluding-fields). + +## Related pages + +- [Relation queries](/orm/prisma-client/queries/relation-queries) +- [Filtering and sorting](/orm/prisma-client/queries/filtering-and-sorting) +- [Prisma Client API reference](/orm/reference/prisma-client-reference#select) diff --git a/apps/docs/content/docs/orm/prisma-client/setup-and-configuration/generating-prisma-client.mdx b/apps/docs/content/docs/orm/prisma-client/setup-and-configuration/generating-prisma-client.mdx new file mode 100644 index 0000000000..de3c272e0e --- /dev/null +++ b/apps/docs/content/docs/orm/prisma-client/setup-and-configuration/generating-prisma-client.mdx @@ -0,0 +1,58 @@ +--- +title: Generating Prisma Client +description: Learn when and how to run prisma generate, configure the generator output, and import the generated client in your app. +url: /orm/prisma-client/setup-and-configuration/generating-prisma-client +metaTitle: Generating Prisma Client +metaDescription: Learn how prisma generate works, how to configure the generator output, and how to import the generated Prisma Client. +--- + +`prisma generate` creates Prisma Client from the models and generator configuration in your `schema.prisma` file. + +## Define a generator + +In Prisma ORM v7, the `output` field is required: + +```prisma title="schema.prisma" +generator client { + provider = "prisma-client" + output = "./generated" +} +``` + +## Generate the client + +Run the following command whenever you add models, change fields, or update generator settings: + +```npm +npx prisma generate +``` + +If you want the CLI-specific options such as `--watch` or `--generator`, see the [`prisma generate` command reference](/cli/generate). + +## Import the generated client + +Import Prisma Client from the output path you configured: + +```ts +import { PrismaClient } from "./generated/client"; + +const prisma = new PrismaClient(); +``` + +## When to run generate + +You should run `prisma generate` after: + +- changing your Prisma schema +- updating generator configuration +- enabling features that affect the client API +- pulling schema changes from another branch or teammate + +In many projects it also makes sense to run `prisma generate` in `postinstall` or before your production build so deployments always use a current client. + +## Related pages + +- [Introduction to Prisma Client](/orm/prisma-client/setup-and-configuration/introduction) +- [Generators in the Prisma schema](/orm/prisma-schema/overview/generators) +- [Prisma CLI reference for generate](/cli/generate) + diff --git a/apps/docs/content/docs/orm/prisma-client/setup-and-configuration/meta.json b/apps/docs/content/docs/orm/prisma-client/setup-and-configuration/meta.json index b1c38488b1..8049067eeb 100644 --- a/apps/docs/content/docs/orm/prisma-client/setup-and-configuration/meta.json +++ b/apps/docs/content/docs/orm/prisma-client/setup-and-configuration/meta.json @@ -2,6 +2,7 @@ "title": "Setup and Configuration", "pages": [ "introduction", + "generating-prisma-client", "custom-model-and-field-names", "read-replicas", "database-polyfills", diff --git a/apps/docs/content/docs/orm/prisma-client/special-fields-and-types/working-with-geometry-fields.mdx b/apps/docs/content/docs/orm/prisma-client/special-fields-and-types/working-with-geometry-fields.mdx index 75e7134993..13f3cfc61c 100644 --- a/apps/docs/content/docs/orm/prisma-client/special-fields-and-types/working-with-geometry-fields.mdx +++ b/apps/docs/content/docs/orm/prisma-client/special-fields-and-types/working-with-geometry-fields.mdx @@ -978,7 +978,7 @@ const locationsWithinOrNull = await prisma.location.findMany({ ## See also - [CRUD operations](/orm/prisma-client/queries/crud) for general query patterns -- [Filtering and sorting](/v6/orm/prisma-client/queries/filtering-and-sorting) for more filter options +- [Filtering and sorting](/orm/prisma-client/queries/filtering-and-sorting) for more filter options - [PostgreSQL extensions](/orm/prisma-schema/postgresql-extensions) for enabling PostGIS - [PostGIS documentation](https://postgis.net/documentation/) for advanced spatial operations - [GeoJSON specification](https://geojson.org/) for geometry format details diff --git a/apps/docs/content/docs/orm/prisma-client/type-safety/operating-against-partial-structures-of-model-types.mdx b/apps/docs/content/docs/orm/prisma-client/type-safety/operating-against-partial-structures-of-model-types.mdx index fc3f8f642d..0a5e708270 100644 --- a/apps/docs/content/docs/orm/prisma-client/type-safety/operating-against-partial-structures-of-model-types.mdx +++ b/apps/docs/content/docs/orm/prisma-client/type-safety/operating-against-partial-structures-of-model-types.mdx @@ -45,9 +45,9 @@ In some scenarios, you may need a _variation_ of the generated `User` type. For As a solution, you can customize the generated model type using Prisma Client's helper types. -The `User` type only contains the model's [scalar](/orm/prisma-schema/data-model/models#scalar-fields) fields, but doesn't account for any relations. That's because [relations are not included by default](/v6/orm/prisma-client/queries/select-fields#return-the-default-fields) in Prisma Client queries. +The `User` type only contains the model's [scalar](/orm/prisma-schema/data-model/models#scalar-fields) fields, but doesn't account for any relations. That's because [relations are not included by default](/orm/prisma-client/queries/select-fields#return-the-default-fields) in Prisma Client queries. -However, sometimes it's useful to have a type available that **includes a relation** (i.e. a type that you'd get from an API call that uses [`include`](/v6/orm/prisma-client/queries/select-fields#return-nested-objects-by-selecting-relation-fields)). Similarly, another useful scenario could be to have a type available that **includes only a subset of the model's scalar fields** (i.e. a type that you'd get from an API call that uses [`select`](/v6/orm/prisma-client/queries/select-fields#select-specific-fields)). +However, sometimes it's useful to have a type available that **includes a relation** (i.e. a type that you'd get from an API call that uses [`include`](/orm/prisma-client/queries/select-fields#return-nested-objects-by-selecting-relation-fields)). Similarly, another useful scenario could be to have a type available that **includes only a subset of the model's scalar fields** (i.e. a type that you'd get from an API call that uses [`select`](/orm/prisma-client/queries/select-fields#select-specific-fields)). One way of achieving this would be to define these types manually in your application code: diff --git a/apps/docs/content/docs/orm/reference/preview-features/client-preview-features.mdx b/apps/docs/content/docs/orm/reference/preview-features/client-preview-features.mdx index 3542c423a0..bd5c183073 100644 --- a/apps/docs/content/docs/orm/reference/preview-features/client-preview-features.mdx +++ b/apps/docs/content/docs/orm/reference/preview-features/client-preview-features.mdx @@ -21,7 +21,7 @@ The following [Preview](/orm/more/releases#preview) feature flags are available | `nativeDistinct` | [5.7.0](https://github.com/prisma/prisma/releases/tag/5.7.0) | [Submit feedback](https://github.com/prisma/prisma/discussions/22287) | | `typedSql` | [5.19.0](https://github.com/prisma/prisma/releases/tag/5.19.0) | [Submit feedback](https://github.com/prisma/prisma/discussions/25106) | | `strictUndefinedChecks` | [5.20.0](https://github.com/prisma/prisma/releases/tag/5.20.0) | [Submit feedback](https://github.com/prisma/prisma/discussions/25271) | -| [`fullTextSearchPostgres`](/v6/orm/prisma-client/queries/full-text-search) | [6.0.0](https://github.com/prisma/prisma/releases/tag/6.0.0) | [Submit feedback](https://github.com/prisma/prisma/issues/25773) | +| [`fullTextSearchPostgres`](/orm/prisma-client/queries/full-text-search) | [6.0.0](https://github.com/prisma/prisma/releases/tag/6.0.0) | [Submit feedback](https://github.com/prisma/prisma/issues/25773) | | `shardKeys` | [6.10.0](https://pris.ly/release/6.10.0) | [Submit feedback](https://github.com/prisma/prisma/issues/) | | [`partialIndexes`](/orm/prisma-schema/data-model/indexes) | [7.4.0](https://pris.ly/release/7.4.0) | [Submit feedback](https://github.com/prisma/prisma/issues/6974) | @@ -65,7 +65,7 @@ In the list below, you can find a history of Prisma Client and Prisma schema fea | [`clientExtensions`](/orm/prisma-client/client-extensions) | [4.7.0](https://github.com/prisma/prisma/releases/tag/4.7.0) | [4.16.0](https://github.com/prisma/prisma/releases/tag/4.16.0) | | [`filteredRelationCount`](/orm/prisma-client/queries/aggregation-grouping-summarizing#filter-the-relation-count) | [4.3.0](https://github.com/prisma/prisma/releases/tag/4.3.0) | [4.16.0](https://github.com/prisma/prisma/releases/tag/4.16.0) | | [`tracing`](/orm/prisma-client/observability-and-logging/opentelemetry-tracing) | [4.2.0](https://github.com/prisma/prisma/releases/tag/4.2.0) | [6.1.0](https://github.com/prisma/prisma/releases/tag/6.1.0) | -| [`orderByNulls`](/v6/orm/prisma-client/queries/filtering-and-sorting#sort-with-null-records-first-or-last) | [4.1.0](https://github.com/prisma/prisma/releases/tag/4.1.0) | [4.16.0](https://github.com/prisma/prisma/releases/tag/4.16.0) | +| [`orderByNulls`](/orm/prisma-client/queries/filtering-and-sorting#sort-with-null-records-first-or-last) | [4.1.0](https://github.com/prisma/prisma/releases/tag/4.1.0) | [4.16.0](https://github.com/prisma/prisma/releases/tag/4.16.0) | | [`referentialIntegrity`](/orm/prisma-schema/data-model/relations/relation-mode) | [3.1.1](https://github.com/prisma/prisma/releases/tag/3.1.1) | [4.7.0](https://github.com/prisma/prisma/releases/tag/4.7.0) | | [`interactiveTransactions`](/orm/prisma-client/queries/transactions#interactive-transactions) | [2.29.0](https://github.com/prisma/prisma/releases/tag/2.29.0) | [4.7.0](https://github.com/prisma/prisma/releases/tag/4.7.0)
with Prisma Accelerate [5.1.1](https://github.com/prisma/prisma/releases/tag/5.1.1) | | [`extendedIndexes`](/orm/prisma-schema/data-model/indexes) | [3.5.0](https://github.com/prisma/prisma/releases/tag/3.5.0) | [4.0.0](https://github.com/prisma/prisma/releases/tag/4.0.0) | @@ -77,7 +77,7 @@ In the list below, you can find a history of Prisma Client and Prisma schema fea | [`namedConstraints`](/orm/prisma-schema/data-model/database-mapping#constraint-and-index-names) | [2.29.0](https://github.com/prisma/prisma/releases/tag/2.29.0) | [3.0.1](https://github.com/prisma/prisma/releases/tag/3.0.1) | | [`referentialActions`](/orm/prisma-schema/data-model/relations/referential-actions) | [2.26.0](https://github.com/prisma/prisma/releases/tag/2.26.0) | [3.0.1](https://github.com/prisma/prisma/releases/tag/3.0.1) | | [`orderByAggregateGroup`](/orm/prisma-client/queries/aggregation-grouping-summarizing#order-by-aggregate-group) | [2.21.0](https://github.com/prisma/prisma/releases/tag/2.21.0) | [3.0.1](https://github.com/prisma/prisma/releases/tag/3.0.1) | -| [`orderByRelation`](/v6/orm/prisma-client/queries/filtering-and-sorting#sort-by-relation) | [2.16.0](https://github.com/prisma/prisma/releases/tag/2.16.0)
aggregates in [2.19.0](https://github.com/prisma/prisma/releases/tag/2.19.0) | [3.0.1](https://github.com/prisma/prisma/releases/tag/3.0.1) | +| [`orderByRelation`](/orm/prisma-client/queries/filtering-and-sorting#sort-by-relation) | [2.16.0](https://github.com/prisma/prisma/releases/tag/2.16.0)
aggregates in [2.19.0](https://github.com/prisma/prisma/releases/tag/2.19.0) | [3.0.1](https://github.com/prisma/prisma/releases/tag/3.0.1) | | [`selectRelationCount`](/orm/prisma-client/queries/aggregation-grouping-summarizing#count-relations) | [2.20.0](https://github.com/prisma/prisma/releases/tag/2.20.0) | [3.0.1](https://github.com/prisma/prisma/releases/tag/3.0.1) | | `napi` | [2.20.0](https://github.com/prisma/prisma/releases/tag/2.20.0) | [3.0.1](https://github.com/prisma/prisma/releases/tag/3.0.1) | | [`groupBy`](/orm/reference/prisma-client-reference#groupby) | [2.14.0](https://github.com/prisma/prisma/releases/tag/2.14.0) | [2.20.0](https://github.com/prisma/prisma/releases/tag/2.20.0) | @@ -87,6 +87,6 @@ In the list below, you can find a history of Prisma Client and Prisma schema fea | [`transactionApi`](/orm/prisma-client/queries/transactions#the-transaction-api) | [2.1.0](https://github.com/prisma/prisma/releases/tag/2.1.0) | [2.11.0](https://github.com/prisma/prisma/releases/tag/2.11.0) | | [`connectOrCreate`](/orm/reference/prisma-client-reference#connectorcreate) | [2.1.0](https://github.com/prisma/prisma/releases/tag/2.1.0) | [2.11.0](https://github.com/prisma/prisma/releases/tag/2.11.0) | | [`atomicNumberOperations`](/orm/reference/prisma-client-reference#atomic-number-operations) | [2.6.0](https://github.com/prisma/prisma/releases/tag/2.6.0) | [2.10.0](https://github.com/prisma/prisma/releases/tag/2.10.0) | -| [`insensitiveFilters` (PostgreSQL)](/v6/orm/prisma-client/queries/filtering-and-sorting#case-insensitive-filtering) | [2.5.0](https://github.com/prisma/prisma/releases/tag/2.5.0) | [2.8.0](https://github.com/prisma/prisma/releases/tag/2.8.0) | +| [`insensitiveFilters` (PostgreSQL)](/orm/prisma-client/queries/filtering-and-sorting#case-insensitive-filtering) | [2.5.0](https://github.com/prisma/prisma/releases/tag/2.5.0) | [2.8.0](https://github.com/prisma/prisma/releases/tag/2.8.0) | | [`aggregateApi`](/orm/prisma-client/queries/aggregation-grouping-summarizing#aggregate) | [2.2.0](https://github.com/prisma/prisma/releases/tag/2.2.0) | [2.5.0](https://github.com/prisma/prisma/releases/tag/2.5.0) | | [`distinct`](/orm/reference/prisma-client-reference#distinct) | [2.3.0](https://github.com/prisma/prisma/releases/tag/2.3.0) | [2.5.0](https://github.com/prisma/prisma/releases/tag/2.5.0) | diff --git a/apps/docs/content/docs/orm/reference/prisma-client-reference.mdx b/apps/docs/content/docs/orm/reference/prisma-client-reference.mdx index 0552094498..009e62d445 100644 --- a/apps/docs/content/docs/orm/reference/prisma-client-reference.mdx +++ b/apps/docs/content/docs/orm/reference/prisma-client-reference.mdx @@ -417,7 +417,7 @@ Use model queries to perform CRUD operations on your models. See also: [CRUD](/o | Name | Example type (`User`) | Required | Description | | ---------------------- | ------------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `where` | `UserWhereUniqueInput` | **Yes** | Wraps all fields of a model so that a record can be selected ([learn more](#filter-on-non-unique-fields-with-userwhereuniqueinput)). | -| `select` | `XOR` | No | [Specifies which properties to include](/v6/orm/prisma-client/queries/select-fields) on the returned object. | +| `select` | `XOR` | No | [Specifies which properties to include](/orm/prisma-client/queries/select-fields) on the returned object. | | `include` | `XOR` | No | [Specifies which relations should be eagerly loaded](/orm/prisma-client/queries/relation-queries) on the returned object. | | `omit` | `XOR` | No | Specifies which properties to exclude on the returned object. Excludes specified fields from the result | | `relationLoadStrategy` | `'join'` or `'query'` | No | **Default: `join`**. [Load strategy](/orm/prisma-client/queries/relation-queries#relation-load-strategies-preview) for relations. Requires `relationJoins` preview feature. | @@ -545,7 +545,7 @@ await prisma.user.findUniqueOrThrow({ | Name | Example type (`User`) | Required | Description | | ---------------------- | ----------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `select` | `XOR` | No | [Specifies which properties to include](/v6/orm/prisma-client/queries/select-fields) on the returned object. | +| `select` | `XOR` | No | [Specifies which properties to include](/orm/prisma-client/queries/select-fields) on the returned object. | | `include` | `XOR` | No | [Specifies which relations should be eagerly loaded](/orm/prisma-client/queries/relation-queries) on the returned object. | | `omit` | `XOR` | No | Specifies which properties to exclude on the returned object. Excludes specified fields from the result. | | `relationLoadStrategy` | `'join'` or `'query'` | No | **Default: `join`**. [Load strategy](/orm/prisma-client/queries/relation-queries#relation-load-strategies-preview) for relations. Requires `relationJoins` preview feature. | @@ -637,7 +637,7 @@ main(); | Name | Type | Required | Description | | ---------------------- | ------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `select` | `XOR` | No | [Specifies which properties to include](/v6/orm/prisma-client/queries/select-fields) on the returned object. | +| `select` | `XOR` | No | [Specifies which properties to include](/orm/prisma-client/queries/select-fields) on the returned object. | | `include` | `XOR` | No | [Specifies which relations should be eagerly loaded](/orm/prisma-client/queries/relation-queries) on the returned object. | | `omit` | `XOR` | No | Specifies which properties to exclude on the returned object. Excludes specified fields from the result | | `relationLoadStrategy` | `'join'` or `'query'` | No | **Default: `join`**. [Load strategy](/orm/prisma-client/queries/relation-queries#relation-load-strategies-preview) for relations. Requires `relationJoins` preview feature. | @@ -677,7 +677,7 @@ const user = await prisma.user.findMany({ | Name | Type | Required | Description | | ---------------------- | -------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `data` | `XOR`UserUncheckedCreateInput>` | **Yes** | Wraps all the model fields in a type so that they can be provided when creating new records. It also includes relation fields which lets you perform (transactional) nested inserts. Fields that are marked as optional or have default values in the datamodel are optional. | -| [`select`](#select) | `XOR` | No | [Specifies which properties to include](/v6/orm/prisma-client/queries/select-fields) on the returned object. | +| [`select`](#select) | `XOR` | No | [Specifies which properties to include](/orm/prisma-client/queries/select-fields) on the returned object. | | [`include`](#include) | `XOR` | No | [Specifies which relations should be eagerly loaded](/orm/prisma-client/queries/relation-queries) on the returned object. | | [`omit`](#omit) | `XOR` | No | Specifies which properties to exclude on the returned object. Excludes specified fields from the result | | `relationLoadStrategy` | `'join'` or `'query'` | No | **Default: `join`**. [Load strategy](/orm/prisma-client/queries/relation-queries#relation-load-strategies-preview) for relations. Requires `relationJoins` preview feature. | @@ -772,7 +772,7 @@ prisma:query COMMIT | ---------------------- | ------------------------------------------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `data` | `XOR`UserUncheckedUpdateInput>` | **Yes** | Wraps all the fields of the model so that they can be provided when updating an existing record. Fields that are marked as optional or have default values in the datamodel are optional. | | `where` | `UserWhereUniqueInput` | **Yes** | Wraps all fields of a model so that a record can be selected ([learn more](#filter-on-non-unique-fields-with-userwhereuniqueinput)). | -| [`select`](#select) | `XOR` | No | [Specifies which properties to include](/v6/orm/prisma-client/queries/select-fields) on the returned object. | +| [`select`](#select) | `XOR` | No | [Specifies which properties to include](/orm/prisma-client/queries/select-fields) on the returned object. | | [`include`](#include) | `XOR` | No | [Specifies which relations should be eagerly loaded](/orm/prisma-client/queries/relation-queries) on the returned object. | | [`omit`](#omit) | `XOR` | No | Specifies which properties to exclude on the returned object. Excludes specified fields from the result. | | `relationLoadStrategy` | `'join'` or `'query'` | No | **Default: `join`**. [Load strategy](/orm/prisma-client/queries/relation-queries#relation-load-strategies-preview) for relations. Requires `relationJoins` preview feature. | @@ -821,7 +821,7 @@ This section covers the usage of the `upsert()` operation. To learn about using | `create` | `XOR`UserUncheckedCreateInput>` | **Yes** | Wraps all the fields of the model so that they can be provided when creating new records. It also includes relation fields which lets you perform (transactional) nested inserts. Fields that are marked as optional or have default values in the datamodel are optional. | | `update` | `XOR`UserUncheckedUpdateInput>` | **Yes** | Wraps all the fields of the model so that they can be provided when updating an existing record. Fields that are marked as optional or have default values in the datamodel are optional. | | `where` | `UserWhereUniqueInput` | **Yes** | Wraps all fields of a model so that a record can be selected ([learn more](#filter-on-non-unique-fields-with-userwhereuniqueinput)). | -| [`select`](#select) | `XOR` | No | [Specifies which properties to include](/v6/orm/prisma-client/queries/select-fields) on the returned object. | +| [`select`](#select) | `XOR` | No | [Specifies which properties to include](/orm/prisma-client/queries/select-fields) on the returned object. | | [`include`](#include) | `XOR` | No | [Specifies which relations should be eagerly loaded](/orm/prisma-client/queries/relation-queries) on the returned object. | | [`omit`](#omit) | `XOR` | No | Specifies which properties to exclude on the returned object. Excludes specified fields from the result | | `relationLoadStrategy` | `'join'` or `'query'` | No | **Default: `join`**. [Load strategy](/orm/prisma-client/queries/relation-queries#relation-load-strategies-preview) for relations. Requires `relationJoins` preview feature. | @@ -1024,7 +1024,7 @@ To delete records that match a certain criteria, use [`deleteMany`](#deletemany) | Name | Type | Required | Description | | ---------------------- | ------------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `where` | `UserWhereUniqueInput` | **Yes** | Wraps all fields of a model so that a record can be selected ([learn more](#filter-on-non-unique-fields-with-userwhereuniqueinput)). | -| [`select`](#select) | `XOR` | No | [Specifies which properties to include](/v6/orm/prisma-client/queries/select-fields) on the returned object. | +| [`select`](#select) | `XOR` | No | [Specifies which properties to include](/orm/prisma-client/queries/select-fields) on the returned object. | | [`include`](#include) | `XOR` | No | [Specifies which relations should be eagerly loaded](/orm/prisma-client/queries/relation-queries) on the returned object. | | [`omit`](#omit) | `XOR` | No | Specifies which properties to exclude on the returned object. Excludes specified fields from the result | | `relationLoadStrategy` | `'join'` or `'query'` | No | **Default: `join`**. [Load strategy](/orm/prisma-client/queries/relation-queries#relation-load-strategies-preview) for relations. Requires `relationJoins` preview feature. | @@ -1117,7 +1117,7 @@ const users = await prisma.user.createMany({ | Name | Type | Required | Description | | --------------------- | --------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `data` | `Enumerable` | **Yes** | Wraps all the model fields in a type so that they can be provided when creating new records. Fields that are marked as optional or have default values in the datamodel are optional. | -| [`select`](#select) | `XOR` | No | [Specifies which properties to include](/v6/orm/prisma-client/queries/select-fields) on the returned objects. | +| [`select`](#select) | `XOR` | No | [Specifies which properties to include](/orm/prisma-client/queries/select-fields) on the returned objects. | | [`omit`](#omit) | `XOR` | No | Specifies which properties to exclude on the returned objects. Excludes specified fields from the result. Mutually exclusive with `select`. | | [`include`](#include) | `XOR` | No | [Specifies which relations should be eagerly loaded](/orm/prisma-client/queries/relation-queries) on the returned objects. | | `skipDuplicates?` | `boolean` | No | Do not insert records with unique fields or ID fields that already exist. Only supported by databases that support [`ON CONFLICT DO NOTHING`](https://www.postgresql.org/docs/9.5/sql-insert.html#SQL-ON-CONFLICT). This excludes MongoDB and SQLServer | @@ -1532,7 +1532,7 @@ See: [Using Raw SQL (`aggregateRaw()`)](/orm/prisma-client/using-raw-sql/raw-que ### `select` -`select` defines which fields are included in the object that Prisma Client returns. See: [Select fields and include relations](/v6/orm/prisma-client/queries/select-fields) . +`select` defines which fields are included in the object that Prisma Client returns. See: [Select fields and include relations](/orm/prisma-client/queries/select-fields) . #### Remarks @@ -1694,7 +1694,7 @@ const result = await prisma.user.findMany({ ### `include` -`include` defines which relations are included in the result that Prisma Client returns. See: [Select fields and include relations](/v6/orm/prisma-client/queries/select-fields) . +`include` defines which relations are included in the result that Prisma Client returns. See: [Select fields and include relations](/orm/prisma-client/queries/select-fields) . #### Remarks @@ -1994,13 +1994,13 @@ The following examples demonstrate how to use TypeScript's `satisfies` operator ### `orderBy` -Sorts a list of records. See also: [Sorting](/v6/orm/prisma-client/queries/filtering-and-sorting) +Sorts a list of records. See also: [Sorting](/orm/prisma-client/queries/filtering-and-sorting) #### Remarks - You can [order by relation fields](#sort-post-by-the-related-user-records-name) - for example, order posts by the author's name. -- In PostgreSQL you can [order by relevance](#sort-post-by-relevance-of-the-title). For details, see [Sort by relevance](/v6/orm/prisma-client/queries/filtering-and-sorting#sort-by-relevance-postgresql-and-mysql). -- You can [sort `null` records first or last](#sort-post-by-the-related-user-records-name-with-null-records-first). For details, see [Sort with nulls first or last](/v6/orm/prisma-client/queries/filtering-and-sorting#sort-with-null-records-first-or-last). +- In PostgreSQL you can [order by relevance](#sort-post-by-relevance-of-the-title). For details, see [Sort by relevance](/orm/prisma-client/queries/filtering-and-sorting#sort-by-relevance-postgresql-and-mysql). +- You can [sort `null` records first or last](#sort-post-by-the-related-user-records-name-with-null-records-first). For details, see [Sort with nulls first or last](/orm/prisma-client/queries/filtering-and-sorting#sort-with-null-records-first-or-last). #### Inputs for `sort` argument @@ -2077,7 +2077,7 @@ const posts = await prisma.post.findMany({ :::info -For PostgreSQL, this feature is still in Preview. [Enable the `fullTextSearchPostgres` feature flag](/v6/orm/prisma-client/queries/full-text-search#enabling-full-text-search-for-postgresql) in order to use it. +For PostgreSQL, this feature is still in Preview. [Enable the `fullTextSearchPostgres` feature flag](/orm/prisma-client/queries/full-text-search#enabling-full-text-search-for-postgresql) in order to use it. ::: @@ -3457,11 +3457,11 @@ const result = await prisma.post.count({ ### `search` -Use [Full-Text Search](/v6/orm/prisma-client/queries/full-text-search) to search within a `String` field. +Use [Full-Text Search](/orm/prisma-client/queries/full-text-search) to search within a `String` field. :::info -For PostgreSQL, this feature is still in Preview. [Enable the `fullTextSearchPostgres` feature flag](/v6/orm/prisma-client/queries/full-text-search#enabling-full-text-search-for-postgresql) in order to use it. +For PostgreSQL, this feature is still in Preview. [Enable the `fullTextSearchPostgres` feature flag](/orm/prisma-client/queries/full-text-search#enabling-full-text-search-for-postgresql) in order to use it. ::: diff --git a/apps/docs/content/docs/postgres/error-reference.mdx b/apps/docs/content/docs/postgres/error-reference.mdx index 53073d6bdd..a995ed5435 100644 --- a/apps/docs/content/docs/postgres/error-reference.mdx +++ b/apps/docs/content/docs/postgres/error-reference.mdx @@ -28,7 +28,7 @@ This error may arise if images or files stored within your table are being fetch In certain cases, a large number of records or fields are unintentionally fetched, which results in exceeding the configured query response size limit. This could happen when [the `where` clause](/orm/reference/prisma-client-reference#where) in the query is incorrect or entirely missing. -**Suggested solution:** Configure the query response size limit to be larger. If the limit is still exceeded, double-check that the `where` clause is filtering data as expected. To prevent fetching too many records, consider using [pagination](/v6/orm/prisma-client/queries/pagination). Additionally, use the [`select`](/orm/reference/prisma-client-reference#select) clause to return only the necessary fields, reducing the response size. +**Suggested solution:** Configure the query response size limit to be larger. If the limit is still exceeded, double-check that the `where` clause is filtering data as expected. To prevent fetching too many records, consider using [pagination](/orm/prisma-client/queries/pagination). Additionally, use the [`select`](/orm/reference/prisma-client-reference#select) clause to return only the necessary fields, reducing the response size. #### Fetching a large volume of data diff --git a/apps/docs/package.json b/apps/docs/package.json index dbdb69e8ce..24618f0beb 100644 --- a/apps/docs/package.json +++ b/apps/docs/package.json @@ -16,6 +16,8 @@ "lint:external-links": "tsx ./scripts/lint-external-links.ts", "lint:images": "tsx ./scripts/lint-images.ts", "lint:code": "tsx ./scripts/lint-code-blocks.ts", + "audit:redirects": "node ./scripts/audit-redirects.mjs", + "audit:redirects:strict": "node ./scripts/audit-redirects.mjs --strict", "lint:spellcheck": "cspell \"content/docs/**/*.mdx\" \"content/docs/**/*.json\" --show-context" }, "dependencies": { diff --git a/apps/docs/scripts/audit-redirects.mjs b/apps/docs/scripts/audit-redirects.mjs new file mode 100644 index 0000000000..6e238fbe63 --- /dev/null +++ b/apps/docs/scripts/audit-redirects.mjs @@ -0,0 +1,145 @@ +import { readFile, readdir } from "node:fs/promises"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; + +const cwd = path.dirname(fileURLToPath(import.meta.url)); +const docsRoot = path.resolve(cwd, ".."); +const broadDestinations = new Set([ + "/docs", + "/docs/orm", + "/docs/orm/reference/supported-databases", + "/docs/orm/prisma-client/queries/crud", + "/docs/orm/prisma-client/setup-and-configuration/introduction", +]); + +function normalizeRoute(route) { + if (route.length > 1 && route.endsWith("/")) return route.slice(0, -1); + return route; +} + +function toDocsRoute(url) { + const normalized = normalizeRoute(url); + if (normalized === "/") return "/docs"; + return `/docs${normalized}`; +} + +function hasPattern(route) { + return route.includes(":") || route.includes("*"); +} + +function segmentCount(route) { + return route.split("/").filter(Boolean).length; +} + +function shouldWarnForBroadRedirect(source, destination) { + if (hasPattern(source)) return false; + if (broadDestinations.has(destination)) return true; + + const sourceDepth = segmentCount(source); + const destinationDepth = segmentCount(destination); + + return sourceDepth >= 4 && destinationDepth + 1 < sourceDepth; +} + +async function walk(dir) { + const entries = await readdir(dir, { withFileTypes: true }); + const files = []; + + for (const entry of entries) { + const fullPath = path.join(dir, entry.name); + if (entry.isDirectory()) { + files.push(...(await walk(fullPath))); + } else if (entry.isFile() && entry.name.endsWith(".mdx")) { + files.push(fullPath); + } + } + + return files; +} + +function extractFrontmatterUrl(raw) { + if (!raw.startsWith("---\n")) return null; + + const end = raw.indexOf("\n---\n", 4); + if (end === -1) return null; + + const frontmatter = raw.slice(4, end); + const match = frontmatter.match(/^url:\s*(.+)$/m); + if (!match) return null; + + const value = match[1].trim(); + + if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) { + return value.slice(1, -1); + } + + return value; +} + +async function collectDocsRoutes() { + const roots = [ + path.join(docsRoot, "content", "docs"), + path.join(docsRoot, "content", "docs.v6"), + ]; + + const routes = new Set(); + + for (const root of roots) { + const files = await walk(root); + + for (const file of files) { + const raw = await readFile(file, "utf8"); + const url = extractFrontmatterUrl(raw); + if (!url) continue; + + routes.add(toDocsRoute(url)); + } + } + + return routes; +} + +async function main() { + const strict = process.argv.includes("--strict"); + const routes = await collectDocsRoutes(); + const vercelConfig = JSON.parse( + await readFile(path.join(docsRoot, "vercel.json"), "utf8"), + ); + + const missing = []; + const broad = []; + + for (const rule of vercelConfig.redirects) { + if (!rule.source.startsWith("/docs") || !rule.destination.startsWith("/docs")) continue; + if (hasPattern(rule.destination)) continue; + + const destination = normalizeRoute(rule.destination); + + if (!routes.has(destination)) { + missing.push(`${rule.source} -> ${destination}`); + continue; + } + + if (shouldWarnForBroadRedirect(rule.source, destination)) { + broad.push(`${rule.source} -> ${destination}`); + } + } + + console.log(`Checked ${vercelConfig.redirects.length} redirects against ${routes.size} docs routes.`); + + if (missing.length > 0) { + console.log("\nMissing redirect destinations:"); + for (const entry of missing) console.log(`- ${entry}`); + } + + if (broad.length > 0) { + console.log("\nBroad redirects to review:"); + for (const entry of broad) console.log(`- ${entry}`); + } + + if (strict && missing.length > 0) { + process.exitCode = 1; + } +} + +await main(); diff --git a/apps/docs/vercel.json b/apps/docs/vercel.json index c03b5e8cf1..5d042a04ee 100644 --- a/apps/docs/vercel.json +++ b/apps/docs/vercel.json @@ -254,7 +254,6 @@ "destination": "/docs/postgres/import-from-existing-database", "permanent": true }, - { "source": "/docs/getting-started", "destination": "/docs", "permanent": true }, { "source": "/docs/accelerate/api-reference", "destination": "/docs/accelerate/reference/api-reference", @@ -483,32 +482,32 @@ }, { "source": "/docs/optimize", - "destination": "/docs/postgres/query-insights", + "destination": "/docs/query-insights", "permanent": true }, { "source": "/docs/optimize/:path*", - "destination": "/docs/postgres/query-insights", + "destination": "/docs/query-insights", "permanent": true }, { "source": "/docs/v6/optimize", - "destination": "/docs/postgres/query-insights", + "destination": "/docs/query-insights", "permanent": true }, { "source": "/docs/v6/optimize/:path*", - "destination": "/docs/postgres/query-insights", + "destination": "/docs/query-insights", "permanent": true }, { "source": "/docs/v6/postgres/query-optimization", - "destination": "/docs/postgres/query-insights", + "destination": "/docs/query-insights", "permanent": true }, { "source": "/docs/v6/postgres/query-optimization/:path*", - "destination": "/docs/postgres/query-insights", + "destination": "/docs/query-insights", "permanent": true }, { "source": "/docs/orm/more", "destination": "/docs/orm/more/releases", "permanent": true }, @@ -780,7 +779,7 @@ }, { "source": "/docs/orm/overview/databases/cockroachdb", - "destination": "/docs/orm/reference/supported-databases", + "destination": "/docs/orm/core-concepts/supported-databases/postgresql", "permanent": true }, { @@ -790,17 +789,17 @@ }, { "source": "/docs/orm/overview/databases/mongodb", - "destination": "/docs/orm/reference/supported-databases", + "destination": "/docs/orm/core-concepts/supported-databases/mongodb", "permanent": true }, { "source": "/docs/orm/overview/databases/mysql", - "destination": "/docs/orm/reference/supported-databases", + "destination": "/docs/orm/core-concepts/supported-databases/mysql", "permanent": true }, { "source": "/docs/orm/overview/databases/neon", - "destination": "/docs/orm/reference/supported-databases", + "destination": "/docs/orm/core-concepts/supported-databases/postgresql", "permanent": true }, { @@ -815,7 +814,7 @@ }, { "source": "/docs/orm/overview/databases/postgresql", - "destination": "/docs/orm/reference/supported-databases", + "destination": "/docs/orm/core-concepts/supported-databases/postgresql", "permanent": true }, { @@ -835,12 +834,12 @@ }, { "source": "/docs/orm/overview/databases/sqlite", - "destination": "/docs/orm/reference/supported-databases", + "destination": "/docs/orm/core-concepts/supported-databases/sqlite", "permanent": true }, { "source": "/docs/orm/overview/databases/supabase", - "destination": "/docs/orm/reference/supported-databases", + "destination": "/docs/orm/core-concepts/supported-databases/postgresql", "permanent": true }, { @@ -894,11 +893,6 @@ "destination": "/docs/orm", "permanent": true }, - { - "source": "/docs/orm/prisma-client", - "destination": "/docs/orm/prisma-client/setup-and-configuration/introduction", - "permanent": true - }, { "source": "/docs/orm/prisma-client/queries/query-optimization-performance", "destination": "/docs/orm/prisma-client/queries/advanced/query-optimization-performance", @@ -1128,36 +1122,6 @@ "destination": "/docs/orm/prisma-client/queries/crud", "permanent": true }, - { - "source": "/docs/orm/prisma-client/queries/excluding-fields", - "destination": "/docs/orm/prisma-client/queries/crud", - "permanent": true - }, - { - "source": "/docs/orm/prisma-client/queries/filtering-and-sorting", - "destination": "/docs/orm/prisma-client/queries/crud", - "permanent": true - }, - { - "source": "/docs/orm/prisma-client/queries/full-text-search", - "destination": "/docs/orm/prisma-client/queries/crud", - "permanent": true - }, - { - "source": "/docs/orm/prisma-client/queries/pagination", - "destination": "/docs/orm/prisma-client/queries/crud", - "permanent": true - }, - { - "source": "/docs/orm/prisma-client/queries/relation-queries", - "destination": "/docs/orm/prisma-client/queries/crud", - "permanent": true - }, - { - "source": "/docs/orm/prisma-client/queries/select-fields", - "destination": "/docs/orm/prisma-client/queries/crud", - "permanent": true - }, { "source": "/docs/orm/prisma-migrate/understanding-prisma-migrate", "destination": "/docs/orm/prisma-migrate", @@ -1328,11 +1292,6 @@ "destination": "/docs/orm/prisma-client/setup-and-configuration/database-polyfills", "permanent": true }, - { - "source": "/docs/orm/prisma-client/setup-and-configuration/generating-prisma-client", - "destination": "/docs/orm/prisma-client/setup-and-configuration/introduction", - "permanent": true - }, { "source": "/docs/orm/prisma-client/setup-and-configuration", "destination": "/docs/orm/prisma-client/setup-and-configuration/introduction", From 9f17ba119d11802ca5c3c776d76031f62fb2714e Mon Sep 17 00:00:00 2001 From: Marc Hess Date: Mon, 27 Apr 2026 14:15:32 -0400 Subject: [PATCH 02/52] fix docs SEO remediation review feedback --- .../more/comparisons/prisma-and-drizzle.mdx | 2 +- .../orm/prisma-client/queries/pagination.mdx | 23 ++++++++++--------- .../orm/reference/prisma-client-reference.mdx | 4 ++-- apps/docs/scripts/audit-redirects.mjs | 6 +++-- apps/docs/vercel.json | 5 ---- 5 files changed, 19 insertions(+), 21 deletions(-) diff --git a/apps/docs/content/docs/orm/more/comparisons/prisma-and-drizzle.mdx b/apps/docs/content/docs/orm/more/comparisons/prisma-and-drizzle.mdx index 0150978907..fdda08c3be 100644 --- a/apps/docs/content/docs/orm/more/comparisons/prisma-and-drizzle.mdx +++ b/apps/docs/content/docs/orm/more/comparisons/prisma-and-drizzle.mdx @@ -326,7 +326,7 @@ Prisma isn’t just an ORM—it’s a complete type-safe data toolkit: Both Drizzle and Prisma ORM support multiple and different kinds of databases. Drizzle achieves this support through driver implementations created by Drizzle, which integrate with existing third-party database drivers. -Prisma ORM has begun adding support for [third-party database drivers](https://www.prisma.io/blog/serverless-database-drivers-kml1ehxorxzv). Prisma also defaults connections to TLS, which improves security. +Prisma ORM has begun adding support for [third-party database drivers](https://www.prisma.io/blog/serverless-database-drivers-KML1ehXORxZV). Prisma also defaults connections to TLS, which improves security. Additionally, Prisma ORM supports CockroachDB, Microsoft SQL Server, and MongoDB, which Drizzle does not currently support. Prisma ORM also offers the [relation mode](/orm/prisma-schema/data-model/relations/relation-mode) that allows Prisma ORM to emulate foreign key constraints for those database engines that do not support it. Drizzle currently supports Cloudflare D1, `bun:sqlite`, and SQLite via HTTP Proxy, which Prisma ORM currently does not. diff --git a/apps/docs/content/docs/orm/prisma-client/queries/pagination.mdx b/apps/docs/content/docs/orm/prisma-client/queries/pagination.mdx index 8c144e1d26..17b435569b 100644 --- a/apps/docs/content/docs/orm/prisma-client/queries/pagination.mdx +++ b/apps/docs/content/docs/orm/prisma-client/queries/pagination.mdx @@ -35,16 +35,18 @@ const firstPage = await prisma.post.findMany({ const lastPost = firstPage[firstPage.length - 1]; -const nextPage = await prisma.post.findMany({ - take: 10, - skip: 1, - cursor: { - id: lastPost.id, - }, - orderBy: { - id: "asc", - }, -}); +const nextPage = lastPost + ? await prisma.post.findMany({ + take: 10, + skip: 1, + cursor: { + id: lastPost.id, + }, + orderBy: { + id: "asc", + }, + }) + : []; ``` ## Which approach to choose @@ -57,4 +59,3 @@ const nextPage = await prisma.post.findMany({ - [Filtering and sorting](/orm/prisma-client/queries/filtering-and-sorting) - [Query Insights](/query-insights) - [Prisma Client API reference](/orm/reference/prisma-client-reference#cursor) - diff --git a/apps/docs/content/docs/orm/reference/prisma-client-reference.mdx b/apps/docs/content/docs/orm/reference/prisma-client-reference.mdx index 009e62d445..3496a88ae5 100644 --- a/apps/docs/content/docs/orm/reference/prisma-client-reference.mdx +++ b/apps/docs/content/docs/orm/reference/prisma-client-reference.mdx @@ -1532,7 +1532,7 @@ See: [Using Raw SQL (`aggregateRaw()`)](/orm/prisma-client/using-raw-sql/raw-que ### `select` -`select` defines which fields are included in the object that Prisma Client returns. See: [Select fields and include relations](/orm/prisma-client/queries/select-fields) . +`select` defines which fields are included in the object that Prisma Client returns. See: [Select fields and include relations](/orm/prisma-client/queries/select-fields). #### Remarks @@ -1694,7 +1694,7 @@ const result = await prisma.user.findMany({ ### `include` -`include` defines which relations are included in the result that Prisma Client returns. See: [Select fields and include relations](/orm/prisma-client/queries/select-fields) . +`include` defines which relations are included in the result that Prisma Client returns. See: [Select fields and include relations](/orm/prisma-client/queries/select-fields). #### Remarks diff --git a/apps/docs/scripts/audit-redirects.mjs b/apps/docs/scripts/audit-redirects.mjs index 6e238fbe63..a10e37374f 100644 --- a/apps/docs/scripts/audit-redirects.mjs +++ b/apps/docs/scripts/audit-redirects.mjs @@ -13,8 +13,10 @@ const broadDestinations = new Set([ ]); function normalizeRoute(route) { - if (route.length > 1 && route.endsWith("/")) return route.slice(0, -1); - return route; + const cleanRoute = route.split(/[?#]/, 1)[0]; + + if (cleanRoute.length > 1 && cleanRoute.endsWith("/")) return cleanRoute.slice(0, -1); + return cleanRoute; } function toDocsRoute(url) { diff --git a/apps/docs/vercel.json b/apps/docs/vercel.json index 5d042a04ee..5b85b555a2 100644 --- a/apps/docs/vercel.json +++ b/apps/docs/vercel.json @@ -485,11 +485,6 @@ "destination": "/docs/query-insights", "permanent": true }, - { - "source": "/docs/optimize/:path*", - "destination": "/docs/query-insights", - "permanent": true - }, { "source": "/docs/v6/optimize", "destination": "/docs/query-insights", From e86b6617139bd1c9dca2eb8b7f21024d268f9a5d Mon Sep 17 00:00:00 2001 From: Marc Hess Date: Mon, 27 Apr 2026 14:58:28 -0400 Subject: [PATCH 03/52] fix next batch of docs redirect destinations --- .../docs/orm/more/dev-environment/index.mdx | 21 ++++++++++++++ .../docs/orm/more/dev-environment/meta.json | 2 +- .../content/docs/postgres/database/index.mdx | 29 +++++++++++++++++++ .../content/docs/postgres/database/meta.json | 1 + .../import-from-existing-database.mdx | 27 +++++++++++++++++ apps/docs/vercel.json | 15 ++++------ 6 files changed, 84 insertions(+), 11 deletions(-) create mode 100644 apps/docs/content/docs/orm/more/dev-environment/index.mdx create mode 100644 apps/docs/content/docs/postgres/database/index.mdx create mode 100644 apps/docs/content/docs/postgres/import-from-existing-database.mdx diff --git a/apps/docs/content/docs/orm/more/dev-environment/index.mdx b/apps/docs/content/docs/orm/more/dev-environment/index.mdx new file mode 100644 index 0000000000..20007f8d78 --- /dev/null +++ b/apps/docs/content/docs/orm/more/dev-environment/index.mdx @@ -0,0 +1,21 @@ +--- +title: Dev environment +description: Set up your local Prisma ORM development environment, including editor tooling and environment variables. +url: /orm/more/dev-environment +metaTitle: Prisma ORM development environment +metaDescription: Learn how to set up your Prisma ORM development environment, editor tooling, and environment variables. +--- + +These guides cover the local development environment around Prisma ORM: editor setup, configuration ergonomics, and environment variable management. + +## Start here + +- [Environment variables](/orm/more/dev-environment/environment-variables) +- [Editor setup](/orm/more/dev-environment/editor-setup) + +## Related pages + +- [Prisma schema overview](/orm/prisma-schema/overview) +- [Prisma CLI](/cli) +- [Prisma Config reference](/orm/reference/prisma-config-reference) + diff --git a/apps/docs/content/docs/orm/more/dev-environment/meta.json b/apps/docs/content/docs/orm/more/dev-environment/meta.json index 0f90c30caf..2e1ba73bd3 100644 --- a/apps/docs/content/docs/orm/more/dev-environment/meta.json +++ b/apps/docs/content/docs/orm/more/dev-environment/meta.json @@ -1,4 +1,4 @@ { "title": "Dev environment", - "pages": ["environment-variables", "editor-setup"] + "pages": ["index", "environment-variables", "editor-setup"] } diff --git a/apps/docs/content/docs/postgres/database/index.mdx b/apps/docs/content/docs/postgres/database/index.mdx new file mode 100644 index 0000000000..d304a6735d --- /dev/null +++ b/apps/docs/content/docs/postgres/database/index.mdx @@ -0,0 +1,29 @@ +--- +title: Database +description: Overview of Prisma Postgres database operations, connections, pooling, backups, and query analysis. +url: /postgres/database +metaTitle: Prisma Postgres database guides +metaDescription: Explore Prisma Postgres database guides for connections, pooling, query insights, backups, and local development. +--- + +This section covers the operational side of Prisma Postgres: how to connect, how pooling works, how to inspect query behavior, and how to manage your database in development and production. + +## Start here + +- [Connecting to your database](/postgres/database/connecting-to-your-database) +- [Connection pooling](/postgres/database/connection-pooling) +- [Query Insights](/postgres/database/query-insights) + +## Operations and maintenance + +- [Backups](/postgres/database/backups) +- [PostgreSQL extensions](/postgres/database/postgres-extensions) +- [Serverless driver](/postgres/database/serverless-driver) +- [Local development](/postgres/database/local-development) + +## Related pages + +- [Prisma Postgres overview](/postgres) +- [Troubleshooting](/postgres/troubleshooting) +- [FAQ](/postgres/faq) + diff --git a/apps/docs/content/docs/postgres/database/meta.json b/apps/docs/content/docs/postgres/database/meta.json index abba0b002e..654ff98b29 100644 --- a/apps/docs/content/docs/postgres/database/meta.json +++ b/apps/docs/content/docs/postgres/database/meta.json @@ -1,6 +1,7 @@ { "title": "Database", "pages": [ + "index", "connecting-to-your-database", "connection-pooling", "query-insights", diff --git a/apps/docs/content/docs/postgres/import-from-existing-database.mdx b/apps/docs/content/docs/postgres/import-from-existing-database.mdx new file mode 100644 index 0000000000..ce079a4925 --- /dev/null +++ b/apps/docs/content/docs/postgres/import-from-existing-database.mdx @@ -0,0 +1,27 @@ +--- +title: Import from existing database +description: Choose the right path to import data from PostgreSQL or MySQL into Prisma Postgres. +url: /postgres/import-from-existing-database +metaTitle: Import from existing database into Prisma Postgres +metaDescription: Choose the right import guide for moving an existing PostgreSQL or MySQL database into Prisma Postgres. +--- + +Use this page to choose the right import path for moving an existing database into Prisma Postgres. + +## Choose your source database + +- [Import from PostgreSQL](/prisma-postgres/import-from-existing-database-postgresql) +- [Import from MySQL](/prisma-postgres/import-from-existing-database-mysql) + +## Before you start + +- Create a Prisma Postgres database first. +- Gather the connection details for your existing database. +- Use a [direct connection](/postgres/database/connecting-to-your-database) when importing data into Prisma Postgres. + +## Related pages + +- [Connecting to your database](/postgres/database/connecting-to-your-database) +- [Prisma Postgres overview](/postgres) +- [Create a database with `create-db`](/postgres/npx-create-db) + diff --git a/apps/docs/vercel.json b/apps/docs/vercel.json index 5b85b555a2..1034b5943c 100644 --- a/apps/docs/vercel.json +++ b/apps/docs/vercel.json @@ -1161,7 +1161,7 @@ { "source": "/docs/orm/tools/prisma-cli", "destination": "/docs/cli", "permanent": true }, { "source": "/docs/platform/platform-cli", - "destination": "/docs/cli/console/platform", + "destination": "/docs/cli/console", "permanent": true }, { @@ -1227,7 +1227,7 @@ }, { "source": "/docs/platform/platform-cli/commands", - "destination": "/docs/cli/console/platform", + "destination": "/docs/cli/console", "permanent": true }, { @@ -1261,11 +1261,6 @@ "destination": "/docs/postgres/error-reference", "permanent": true }, - { - "source": "/docs/postgres/database", - "destination": "/docs/postgres/database/caching", - "permanent": true - }, { "source": "/docs/showcase", "destination": "/docs", "permanent": true }, { "source": "/docs/getting-started/quickstart-prismaPostgres", @@ -1662,12 +1657,12 @@ }, { "source": "/docs/guides/upgrade-from-prisma-1/should-you-upgrade", - "destination": "/docs/guides/upgrade-from-prisma-1/how-to-upgrade", + "destination": "/docs/guides/upgrade-prisma-orm/v1", "permanent": true }, { "source": "/docs/reference/tools-and-interfaces/prisma-schema/models", - "destination": "/docs/reference/tools-and-interfaces/prisma-schema/data-model", + "destination": "/docs/orm/prisma-schema/data-model/models", "permanent": true }, { @@ -1732,7 +1727,7 @@ }, { "source": "/docs/reference/tools-and-interfaces/prisma-schema/prisma-schema-file", - "destination": "/docs/reference/tools-and-interfaces/prisma-schema", + "destination": "/docs/orm/prisma-schema/overview", "permanent": true }, { From a49d98d02631f9c5f8968e25e7af10964cfa97de Mon Sep 17 00:00:00 2001 From: Marc Hess Date: Mon, 27 Apr 2026 15:08:50 -0400 Subject: [PATCH 04/52] fix setup-prisma redirect destinations --- apps/docs/vercel.json | 104 +++++++++++++++++++++--------------------- 1 file changed, 52 insertions(+), 52 deletions(-) diff --git a/apps/docs/vercel.json b/apps/docs/vercel.json index 1034b5943c..88eb68622e 100644 --- a/apps/docs/vercel.json +++ b/apps/docs/vercel.json @@ -1672,7 +1672,7 @@ }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch-sql-node-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases-node-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql", "permanent": true }, { @@ -1682,7 +1682,7 @@ }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch-sql-node-mysql", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases-node-mysql", + "destination": "/docs/prisma-orm/quickstart/mysql", "permanent": true }, { @@ -1692,7 +1692,7 @@ }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch-prisma-migrate-node-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases-node-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#6-create-and-apply-your-first-migration", "permanent": true }, { @@ -1702,7 +1702,7 @@ }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch-prisma-migrate-node-mysql", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases-node-mysql", + "destination": "/docs/prisma-orm/quickstart/mysql#6-create-and-apply-your-first-migration", "permanent": true }, { @@ -1712,7 +1712,7 @@ }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch-node-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases-node-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql", "permanent": true }, { @@ -1722,7 +1722,7 @@ }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch-node-mysql", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases-node-mysql", + "destination": "/docs/prisma-orm/quickstart/mysql", "permanent": true }, { @@ -1772,12 +1772,12 @@ }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch-prisma-migrate", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch-typescript-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#6-create-and-apply-your-first-migration", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch-sql", - "destination": "/docs/getting-started/prisma-orm", + "destination": "/docs/getting-started", "permanent": true }, { @@ -1993,42 +1993,42 @@ }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/connect-your-database-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/connect-your-database-typescript-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#4-initialize-prisma-orm", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/using-prisma-migrate-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/using-prisma-migrate-typescript-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#6-create-and-apply-your-first-migration", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/install-prisma-client-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/install-prisma-client-typescript-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#2-install-required-dependencies", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/querying-the-database-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/querying-the-database-typescript-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#8-write-your-first-query", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/next-steps-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/next-steps-typescript-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#next-steps", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/connect-your-database-node-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/connect-your-database-node-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#4-initialize-prisma-orm", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/using-prisma-migrate-node-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/using-prisma-migrate-node-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#6-create-and-apply-your-first-migration", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/install-prisma-client-node-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/install-prisma-client-node-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#2-install-required-dependencies", "permanent": true }, { @@ -2038,42 +2038,42 @@ }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/next-steps-node-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/next-steps-node-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#next-steps", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/relational-databases/connect-your-database-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/connect-your-database-typescript-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#4-initialize-prisma-orm", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/relational-databases/connect-your-database-node-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/connect-your-database-node-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#4-initialize-prisma-orm", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/relational-databases/using-prisma-migrate-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/using-prisma-migrate-typescript-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#6-create-and-apply-your-first-migration", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/relational-databases/using-prisma-migrate-node-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/using-prisma-migrate-node-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#6-create-and-apply-your-first-migration", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/relational-databases/install-prisma-client-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/install-prisma-client-typescript-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#2-install-required-dependencies", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/relational-databases/install-prisma-client-node-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/install-prisma-client-node-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#2-install-required-dependencies", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/relational-databases/querying-the-database-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/querying-the-database-typescript-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#8-write-your-first-query", "permanent": true }, { @@ -2083,12 +2083,12 @@ }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/relational-databases/next-steps-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/next-steps-typescript-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#next-steps", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/relational-databases/next-steps-node-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases/next-steps-node-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql#next-steps", "permanent": true }, { @@ -2098,7 +2098,7 @@ }, { "source": "/docs/getting-started/setup-prisma/start-from-scratch/relational-databases-node-postgres", - "destination": "/docs/getting-started/prisma-orm/start-from-scratch/relational-databases-node-postgresql", + "destination": "/docs/prisma-orm/quickstart/postgresql", "permanent": true }, { @@ -2108,122 +2108,122 @@ }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/connect-your-database-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/connect-your-database-typescript-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#3-connect-your-database", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/introspection-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/introspection-typescript-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#4-introspect-your-database", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/install-prisma-client-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/install-prisma-client-typescript-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#1-set-up-prisma-orm", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/querying-the-database-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/querying-the-database-typescript-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#8-query-your-database", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/next-steps-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/next-steps-typescript-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#next-steps", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/connect-your-database-node-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/connect-your-database-node-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#3-connect-your-database", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/introspection-node-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/introspection-node-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#4-introspect-your-database", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/install-prisma-client-node-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/install-prisma-client-node-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#1-set-up-prisma-orm", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/querying-the-database-node-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/querying-the-database-node-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#8-query-your-database", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/next-steps-node-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/next-steps-node-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#next-steps", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases/connect-your-database-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/connect-your-database-typescript-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#3-connect-your-database", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases/connect-your-database-node-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/connect-your-database-node-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#3-connect-your-database", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases/introspection-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/introspection-typescript-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#4-introspect-your-database", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases/introspection-node-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/introspection-node-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#4-introspect-your-database", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases/baseline-your-database-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/baseline-your-database-typescript-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#5-baseline-your-database", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases/baseline-your-database-node-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/baseline-your-database-node-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#5-baseline-your-database", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases/install-prisma-client-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/install-prisma-client-typescript-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#1-set-up-prisma-orm", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases/install-prisma-client-node-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/install-prisma-client-node-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#1-set-up-prisma-orm", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases/querying-the-database-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/querying-the-database-typescript-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#8-query-your-database", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases/querying-the-database-node-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/querying-the-database-node-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#8-query-your-database", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases/evolve-your-schema-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/evolve-your-schema-typescript-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#9-evolve-your-schema", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases/evolve-your-schema-node-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/evolve-your-schema-node-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#9-evolve-your-schema", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases/next-steps-typescript-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/next-steps-typescript-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#next-steps", "permanent": true }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases/next-steps-node-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases/next-steps-node-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql#next-steps", "permanent": true }, { @@ -2233,7 +2233,7 @@ }, { "source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases-node-postgres", - "destination": "/docs/getting-started/prisma-orm/add-to-existing-project/postgresql/relational-databases-node-postgresql", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql", "permanent": true }, { From 8ce68ee5164707708ec6d4306f9c88761565e15a Mon Sep 17 00:00:00 2001 From: Marc Hess Date: Mon, 27 Apr 2026 15:15:59 -0400 Subject: [PATCH 05/52] fix concepts redirect destinations --- apps/docs/vercel.json | 82 +++++++++++++++++++++---------------------- 1 file changed, 41 insertions(+), 41 deletions(-) diff --git a/apps/docs/vercel.json b/apps/docs/vercel.json index 88eb68622e..ac344797bf 100644 --- a/apps/docs/vercel.json +++ b/apps/docs/vercel.json @@ -1792,7 +1792,7 @@ }, { "source": "/docs/concepts/components/prisma-client/distinct", - "destination": "/docs/concepts/components/prisma-client/aggregation-grouping-summarizing#select-distinct", + "destination": "/docs/orm/prisma-client/queries/aggregation-grouping-summarizing#select-distinct", "permanent": true }, { @@ -1802,12 +1802,12 @@ }, { "source": "/docs/concepts/components/prisma-client/constructor", - "destination": "/docs/reference/api-reference/prisma-client-reference#prismaclient", + "destination": "/docs/orm/reference/prisma-client-reference#prismaclient", "permanent": true }, { "source": "/docs/concepts/components/prisma-client/field-selection", - "destination": "/docs/orm/prisma-client/queries/crud", + "destination": "/docs/orm/prisma-client/queries/select-fields", "permanent": true }, { @@ -1817,12 +1817,12 @@ }, { "source": "/docs/concepts/components/prisma-client/sorting", - "destination": "/docs/orm/prisma-client/queries/crud", + "destination": "/docs/orm/prisma-client/queries/filtering-and-sorting", "permanent": true }, { "source": "/docs/concepts/components/prisma-client/filtering", - "destination": "/docs/orm/prisma-client/queries/crud", + "destination": "/docs/orm/prisma-client/queries/filtering-and-sorting", "permanent": true }, { @@ -1837,7 +1837,7 @@ }, { "source": "/docs/concepts/components/prisma-client/group-by", - "destination": "/docs/concepts/components/prisma-client/aggregation-grouping-summarizing#group-by-preview", + "destination": "/docs/orm/prisma-client/queries/aggregation-grouping-summarizing#group-by", "permanent": true }, { @@ -1847,17 +1847,17 @@ }, { "source": "/docs/concepts/components/preview-features/native-types/native-types-mappings", - "destination": "/docs/reference/api-reference/prisma-schema-reference#model-field-scalar-types", + "destination": "/docs/orm/reference/prisma-schema-reference#model-field-scalar-types", "permanent": true }, { "source": "/docs/concepts/components/preview-features/native-types", - "destination": "/docs/concepts/components/prisma-schema/data-model#native-types-mapping", + "destination": "/docs/orm/prisma-schema/data-model/models#native-types-mapping", "permanent": true }, { "source": "/docs/concepts/components/prisma-client/generating-prisma-client", - "destination": "/docs/orm/prisma-client/setup-and-configuration/introduction", + "destination": "/docs/orm/prisma-client/setup-and-configuration/generating-prisma-client", "permanent": true }, { @@ -1897,7 +1897,7 @@ }, { "source": "/docs/reference/utility-types-reference", - "destination": "/docs/reference/api-reference/prisma-client-reference#prismavalidator", + "destination": "/docs/orm/reference/prisma-client-reference#utility-types", "permanent": true }, { @@ -1937,42 +1937,42 @@ }, { "source": "/docs/guides/general-guides/database-workflows/unique-constraints-and-indexes", - "destination": "/docs/concepts/components/prisma-schema/data-model#defining-a-unique-field", + "destination": "/docs/orm/prisma-schema/data-model/models#defining-a-unique-field", "permanent": true }, { "source": "/docs/guides/general-guides/database-workflows/unique-constraints-and-indexes/mysql", - "destination": "/docs/concepts/components/prisma-schema/data-model#defining-a-unique-field", + "destination": "/docs/orm/prisma-schema/data-model/models#defining-a-unique-field", "permanent": true }, { "source": "/docs/guides/database/advanced-database-tasks/unique-constraints-and-indexes/postgresql", - "destination": "/docs/concepts/components/prisma-schema/data-model#defining-a-unique-field", + "destination": "/docs/orm/prisma-schema/data-model/models#defining-a-unique-field", "permanent": true }, { "source": "/docs/guides/general-guides/database-workflows/unique-constraints-and-indexes/sqlite", - "destination": "/docs/concepts/components/prisma-schema/data-model#defining-a-unique-field", + "destination": "/docs/orm/prisma-schema/data-model/models#defining-a-unique-field", "permanent": true }, { "source": "/docs/guides/general-guides/database-workflows/foreign-keys", - "destination": "/docs/concepts/components/prisma-schema/relations#relational-databases", + "destination": "/docs/orm/prisma-schema/data-model/relations#relational-databases", "permanent": true }, { "source": "/docs/guides/general-guides/database-workflows/foreign-keys/mysql", - "destination": "/docs/concepts/components/prisma-schema/relations#relational-databases", + "destination": "/docs/orm/prisma-schema/data-model/relations#relational-databases", "permanent": true }, { "source": "/docs/guides/general-guides/database-workflows/foreign-keys/postgresql", - "destination": "/docs/concepts/components/prisma-schema/relations#relational-databases", + "destination": "/docs/orm/prisma-schema/data-model/relations#relational-databases", "permanent": true }, { "source": "/docs/guides/general-guides/database-workflows/foreign-keys/sqlite", - "destination": "/docs/concepts/components/prisma-schema/relations#relational-databases", + "destination": "/docs/orm/prisma-schema/data-model/relations#relational-databases", "permanent": true }, { "source": "/docs/mongodb", "destination": "/docs/orm/", "permanent": true }, @@ -2269,22 +2269,22 @@ }, { "source": "/docs/concepts/components/preview-features/sql-server/sql-server-connection-string", - "destination": "/docs/orm/reference/supported-databases", + "destination": "/docs/orm/core-concepts/supported-databases/sql-server#connection-details", "permanent": true }, { "source": "/docs/concepts/components/preview-features/sql-server/sql-server-local", - "destination": "/docs/orm/reference/supported-databases", + "destination": "/docs/orm/core-concepts/supported-databases/sql-server#local-setup", "permanent": true }, { "source": "/docs/concepts/components/preview-features/sql-server/sql-server-docker", - "destination": "/docs/orm/reference/supported-databases", + "destination": "/docs/orm/core-concepts/supported-databases/sql-server#local-setup", "permanent": true }, { "source": "/docs/concepts/components/preview-features/sql-server", - "destination": "/docs/orm/reference/supported-databases", + "destination": "/docs/orm/core-concepts/supported-databases/sql-server", "permanent": true }, { @@ -2374,12 +2374,12 @@ }, { "source": "/docs/concepts/components/prisma-cli/installation", - "destination": "/docs/reference/api-reference/command-reference#installation", + "destination": "/docs/cli#installation", "permanent": true }, { "source": "/docs/guides/other/troubleshooting-orm/help-articles/finding-entities-based-on-relation", - "destination": "/docs/concepts/components/prisma-client/relation-queries#filter-on-presence-of-related-records", + "destination": "/docs/orm/prisma-client/queries/relation-queries#filter-on-presence-of-related-records", "permanent": true }, { @@ -2901,7 +2901,7 @@ { "source": "/docs/concepts/overview", "destination": "/docs/orm", "permanent": true }, { "source": "/docs/concepts/components/prisma-client/working-with-prismaclient/generating-prisma-client", - "destination": "/docs/orm/prisma-client/setup-and-configuration/introduction", + "destination": "/docs/orm/prisma-client/setup-and-configuration/generating-prisma-client", "permanent": true }, { @@ -2951,22 +2951,22 @@ }, { "source": "/docs/concepts/components/prisma-client/select-fields", - "destination": "/docs/orm/prisma-client/queries/crud", + "destination": "/docs/orm/prisma-client/queries/select-fields", "permanent": true }, { "source": "/docs/concepts/components/prisma-client/relation-queries", - "destination": "/docs/orm/prisma-client/queries/crud", + "destination": "/docs/orm/prisma-client/queries/relation-queries", "permanent": true }, { "source": "/docs/concepts/components/prisma-client/filtering-and-sorting", - "destination": "/docs/orm/prisma-client/queries/crud", + "destination": "/docs/orm/prisma-client/queries/filtering-and-sorting", "permanent": true }, { "source": "/docs/concepts/components/prisma-client/pagination", - "destination": "/docs/orm/prisma-client/queries/crud", + "destination": "/docs/orm/prisma-client/queries/pagination", "permanent": true }, { @@ -2981,32 +2981,32 @@ }, { "source": "/docs/concepts/components/prisma-client/full-text-search", - "destination": "/docs/orm/prisma-client/queries/crud", + "destination": "/docs/orm/prisma-client/queries/full-text-search", "permanent": true }, { "source": "/docs/concepts/components/prisma-client/custom-validation", - "destination": "/docs/orm/prisma-client/queries/crud", + "destination": "/docs/v6/orm/prisma-client/queries/custom-validation", "permanent": true }, { "source": "/docs/concepts/components/prisma-client/computed-fields", - "destination": "/docs/orm/prisma-client/queries/crud", + "destination": "/docs/v6/orm/prisma-client/queries/computed-fields", "permanent": true }, { "source": "/docs/concepts/components/prisma-client/excluding-fields", - "destination": "/docs/orm/prisma-client/queries/crud", + "destination": "/docs/orm/prisma-client/queries/excluding-fields", "permanent": true }, { "source": "/docs/concepts/components/prisma-client/custom-models", - "destination": "/docs/orm/prisma-client/queries/crud", + "destination": "/docs/v6/orm/prisma-client/queries/custom-models", "permanent": true }, { "source": "/docs/concepts/components/prisma-client/case-sensitivity", - "destination": "/docs/orm/prisma-client/queries/crud", + "destination": "/docs/v6/orm/prisma-client/queries/case-sensitivity", "permanent": true }, { @@ -3096,12 +3096,12 @@ }, { "source": "/docs/concepts/components/prisma-client/middleware/logging-middleware", - "destination": "/docs/orm/prisma-client/client-extensions/middleware/logging-middleware", + "destination": "/docs/orm/prisma-client/client-extensions", "permanent": true }, { "source": "/docs/concepts/components/prisma-client/middleware/session-data-middleware", - "destination": "/docs/orm/prisma-client/client-extensions/middleware/session-data-middleware", + "destination": "/docs/orm/prisma-client/client-extensions", "permanent": true }, { @@ -3121,7 +3121,7 @@ }, { "source": "/docs/concepts/components/prisma-client/advanced-type-safety/prisma-validator", - "destination": "/docs/orm/prisma-client/type-safety", + "destination": "/docs/v6/orm/prisma-client/type-safety/prisma-validator", "permanent": true }, { @@ -3281,7 +3281,7 @@ }, { "source": "/docs/concepts/components/prisma-migrate/legacy-migrate", - "destination": "/docs/orm/prisma-migrate/understanding-prisma-migrate/legacy-migrate", + "destination": "/docs/v6/orm/prisma-migrate/understanding-prisma-migrate/legacy-migrate", "permanent": true }, { @@ -3676,7 +3676,7 @@ }, { "source": "/docs/concepts/components/prisma-client/module-bundlers", - "destination": "/docs/orm/prisma-client/deployment/module-bundlers", + "destination": "/docs/v6/orm/prisma-client/deployment/module-bundlers", "permanent": true }, { @@ -5294,7 +5294,7 @@ { "source": "/docs/guides/other/prisma-dev", "destination": "/docs/guides", "permanent": true }, { "source": "/docs/concepts/components/prisma-migrate/migration-troubleshooting", - "destination": "/docs/concepts", + "destination": "/docs/orm/prisma-migrate/understanding-prisma-migrate/limitations-and-known-issues", "permanent": true }, { "source": "/docs/guide/nextjs", "destination": "/docs", "permanent": true }, From c73d06d75d5a0fa2fed8f78e7a7b2781cd3ea8c4 Mon Sep 17 00:00:00 2001 From: Marc Hess Date: Mon, 27 Apr 2026 15:33:54 -0400 Subject: [PATCH 06/52] Fix remaining broken docs redirect targets --- apps/docs/scripts/audit-redirects.mjs | 8 + apps/docs/vercel.json | 202 +++++++++++++------------- 2 files changed, 111 insertions(+), 99 deletions(-) diff --git a/apps/docs/scripts/audit-redirects.mjs b/apps/docs/scripts/audit-redirects.mjs index a10e37374f..39c55d7bcf 100644 --- a/apps/docs/scripts/audit-redirects.mjs +++ b/apps/docs/scripts/audit-redirects.mjs @@ -85,6 +85,10 @@ async function collectDocsRoutes() { ]; const routes = new Set(); + const extraRoutes = new Set([ + "/docs/llms-full.txt", + "/docs/llms-full-v6.txt", + ]); for (const root of roots) { const files = await walk(root); @@ -98,6 +102,10 @@ async function collectDocsRoutes() { } } + for (const route of extraRoutes) { + routes.add(route); + } + return routes; } diff --git a/apps/docs/vercel.json b/apps/docs/vercel.json index ac344797bf..4d27ea0c7d 100644 --- a/apps/docs/vercel.json +++ b/apps/docs/vercel.json @@ -1782,12 +1782,12 @@ }, { "source": "/docs/guides/prisma-guides/prisma-migrate-guides", - "destination": "/docs/guides/prisma-guides/add-prisma-migrate-to-a-project", + "destination": "/docs/orm/prisma-migrate/getting-started", "permanent": true }, { "source": "/docs/guides/prisma-guides/prisma-migrate-guides/add-prisma-migrate-to-a-project", - "destination": "/docs/guides/prisma-guides/add-prisma-migrate-to-a-project", + "destination": "/docs/orm/prisma-migrate/getting-started", "permanent": true }, { @@ -2299,27 +2299,27 @@ }, { "source": "/docs/concepts/components/prisma-data-platform", - "destination": "/docs/concepts/data-platform", + "destination": "/docs/console", "permanent": true }, { "source": "/docs/about/prisma/platform-releases", - "destination": "/docs/concepts/data-platform/about-platform/platform-releases", + "destination": "/docs/console/more/feature-maturity", "permanent": true }, { "source": "/docs/data-platform/about/platform-limits-and-status", - "destination": "/docs/data-platform/platform-console/limits", + "destination": "/docs/console/more/feature-maturity", "permanent": true }, { "source": "/docs/data-platform/about/platform-releases", - "destination": "/docs/data-platform/platform-console/maturity-levels", + "destination": "/docs/console/more/feature-maturity", "permanent": true }, { "source": "/docs/data-platform/accounts", - "destination": "/docs/data-platform/classic-projects/platform/account", + "destination": "/docs/console/concepts#user-account", "permanent": true }, { @@ -2334,17 +2334,17 @@ }, { "source": "/docs/data-platform/members/user-roles", - "destination": "/docs/data-platform/classic-projects/platform/members/roles-permissions", + "destination": "/docs/console/concepts#workspace", "permanent": true }, { "source": "/docs/data-platform/members/data-collaborators", - "destination": "/docs/data-platform/classic-projects/platform/members/add", + "destination": "/docs/console/concepts#workspace", "permanent": true }, { "source": "/docs/data-platform/environments/edit-settings/change-database-connection-string", - "destination": "/docs/data-platform/classic-projects/platform/troubleshooting/cannot-change-db-of-env", + "destination": "/docs/console/concepts#resources", "permanent": true }, { @@ -2464,127 +2464,127 @@ }, { "source": "/docs/data-platform/about/releases", - "destination": "/docs/data-platform/platform-console/maturity-levels", + "destination": "/docs/console/more/feature-maturity", "permanent": true }, { "source": "/docs/data-platform/about/limits-and-status", - "destination": "/docs/data-platform/platform-console/limits", + "destination": "/docs/console/more/feature-maturity", "permanent": true }, { "source": "/docs/data-platform/about", - "destination": "/docs/data-platform/platform-console/about", + "destination": "/docs/console", "permanent": true }, { "source": "/docs/data-platform/static-ips", - "destination": "/docs/data-platform/classic-projects/platform/static-ips", + "destination": "/docs/accelerate/static-ip", "permanent": true }, { "source": "/docs/data-platform/projects/create", - "destination": "/docs/data-platform/classic-projects/platform/projects/create", + "destination": "/docs/console/getting-started#step-3-create-a-project", "permanent": true }, { "source": "/docs/data-platform/projects/edit-settings", - "destination": "/docs/data-platform/classic-projects/platform/projects/edit-settings", + "destination": "/docs/console/concepts#project", "permanent": true }, { "source": "/docs/data-platform/projects/delete-project", - "destination": "/docs/data-platform/classic-projects/platform/projects/delete-project", + "destination": "/docs/console/concepts#project", "permanent": true }, { "source": "/docs/data-platform/projects", - "destination": "/docs/data-platform/classic-projects/platform/projects", + "destination": "/docs/console/concepts#project", "permanent": true }, { "source": "/docs/data-platform/environments/view-all", - "destination": "/docs/data-platform/classic-projects/platform/environments/view-all", + "destination": "/docs/console/concepts#resources", "permanent": true }, { "source": "/docs/data-platform/environments/create", - "destination": "/docs/data-platform/classic-projects/platform/environments/create", + "destination": "/docs/console/concepts#resources", "permanent": true }, { "source": "/docs/data-platform/environments/edit-settings/edit-name-and-url-handle", - "destination": "/docs/data-platform/classic-projects/platform/environments/edit-settings/edit-name-and-url-handle", + "destination": "/docs/console/concepts#resources", "permanent": true }, { "source": "/docs/data-platform/environments/edit-settings/change-default-environment", - "destination": "/docs/data-platform/classic-projects/platform/environments/edit-settings/change-default-environment", + "destination": "/docs/console/concepts#resources", "permanent": true }, { "source": "/docs/data-platform/environments/edit-settings", - "destination": "/docs/data-platform/classic-projects/platform/environments/edit-settings", + "destination": "/docs/console/concepts#resources", "permanent": true }, { "source": "/docs/data-platform/environments/delete", - "destination": "/docs/data-platform/classic-projects/platform/environments/delete", + "destination": "/docs/console/concepts#resources", "permanent": true }, { "source": "/docs/data-platform/environments", - "destination": "/docs/data-platform/classic-projects/platform/environments", + "destination": "/docs/console/concepts#resources", "permanent": true }, { "source": "/docs/data-platform/members/roles-permissions", - "destination": "/docs/data-platform/classic-projects/platform/members/roles-permissions", + "destination": "/docs/console/concepts#workspace", "permanent": true }, { "source": "/docs/data-platform/members/add", - "destination": "/docs/data-platform/classic-projects/platform/members/add", + "destination": "/docs/console/concepts#workspace", "permanent": true }, { "source": "/docs/data-platform/members/change-role", - "destination": "/docs/data-platform/classic-projects/platform/members/change-role", + "destination": "/docs/console/concepts#workspace", "permanent": true }, { "source": "/docs/data-platform/members/remove", - "destination": "/docs/data-platform/classic-projects/platform/members/remove", + "destination": "/docs/console/concepts#workspace", "permanent": true }, { "source": "/docs/data-platform/members", - "destination": "/docs/data-platform/classic-projects/platform/members", + "destination": "/docs/console/concepts#workspace", "permanent": true }, { "source": "/docs/data-platform/data-browser", - "destination": "/docs/data-platform/classic-projects/platform/data-browser", + "destination": "/docs/console/concepts#resources", "permanent": true }, { "source": "/docs/data-platform/query-console", - "destination": "/docs/data-platform/classic-projects/platform/query-console", + "destination": "/docs/console/concepts#resources", "permanent": true }, { "source": "/docs/data-platform/schema-viewer", - "destination": "/docs/data-platform/classic-projects/platform/schema-viewer", + "destination": "/docs/console/concepts#resources", "permanent": true }, { "source": "/docs/data-platform/account", - "destination": "/docs/data-platform/classic-projects/platform/account", + "destination": "/docs/console/concepts#user-account", "permanent": true }, { "source": "/docs/data-platform/github-integration", - "destination": "/docs/data-platform/classic-projects/platform/github-integration", + "destination": "/docs/console/concepts#resources", "permanent": true }, { @@ -2599,17 +2599,17 @@ }, { "source": "/docs/data-platform/billing/invoices", - "destination": "/docs/data-platform/classic-projects/platform/billing/invoices", + "destination": "/docs/console/concepts#workspace", "permanent": true }, { "source": "/docs/data-platform/billing/data-proxy-usage", - "destination": "/docs/data-platform/classic-projects/platform/billing/data-proxy-usage", + "destination": "/docs/console/concepts#workspace", "permanent": true }, { "source": "/docs/data-platform/billing/payment-method-and-billing-information", - "destination": "/docs/data-platform/classic-projects/platform/billing/payment-method-and-billing-information", + "destination": "/docs/console/concepts#workspace", "permanent": true }, { @@ -2619,97 +2619,97 @@ }, { "source": "/docs/data-platform/troubleshooting/connection-to-db-timed-out", - "destination": "/docs/data-platform/classic-projects/platform/troubleshooting/connection-to-db-timed-out", + "destination": "/docs/console/more/support", "permanent": true }, { "source": "/docs/data-platform/troubleshooting/cannot-change-db-of-env", - "destination": "/docs/data-platform/classic-projects/platform/troubleshooting/cannot-change-db-of-env", + "destination": "/docs/console/more/support", "permanent": true }, { "source": "/docs/data-platform/troubleshooting/cannot-edit-schema-file", - "destination": "/docs/data-platform/classic-projects/platform/troubleshooting/cannot-edit-schema-file", + "destination": "/docs/console/more/support", "permanent": true }, { "source": "/docs/data-platform/troubleshooting/schema-file-does-not-update", - "destination": "/docs/data-platform/classic-projects/platform/troubleshooting/schema-file-does-not-update", + "destination": "/docs/console/more/support", "permanent": true }, { "source": "/docs/data-platform/troubleshooting", - "destination": "/docs/data-platform/platform-console/support", + "destination": "/docs/console/more/support", "permanent": true }, { "source": "/docs/data-platform/contact-support", - "destination": "/docs/data-platform/platform-console/support", + "destination": "/docs/console/more/support", "permanent": true }, { "source": "/docs/data-platform/cloud-projects/platform/account", - "destination": "/docs/data-platform/platform-console/concepts", + "destination": "/docs/console/concepts#user-account", "permanent": true }, { "source": "/docs/data-platform/cloud-projects/platform/projects", - "destination": "/docs/data-platform/platform-console/concepts/projects", + "destination": "/docs/console/concepts#project", "permanent": true }, { "source": "/docs/data-platform/cloud-projects/platform/organizations", - "destination": "/docs/data-platform/platform-console/concepts/workspaces", + "destination": "/docs/console/concepts#workspace", "permanent": true }, { "source": "/docs/data-platform/cloud-projects/platform/billing", - "destination": "/docs/data-platform/platform-console/concepts/workspaces", + "destination": "/docs/console/concepts#workspace", "permanent": true }, { "source": "/docs/data-platform/cloud-projects/platform", - "destination": "/docs/data-platform/platform-console", + "destination": "/docs/console", "permanent": true }, { "source": "/docs/data-platform/cloud-projects/faq", - "destination": "/docs/data-platform/platform-console/limits", + "destination": "/docs/console/more/support", "permanent": true }, { "source": "/docs/data-platform/cloud-projects/support", - "destination": "/docs/data-platform/platform-console/support", + "destination": "/docs/console/more/support", "permanent": true }, { "source": "/docs/data-platform/cloud-projects/about-cloud-projects", - "destination": "/docs/data-platform/platform-console/about", + "destination": "/docs/console", "permanent": true }, { "source": "/docs/data-platform/cloud-projects", - "destination": "/docs/data-platform/platform-console", + "destination": "/docs/console", "permanent": true }, { "source": "/docs/data-platform/classic-projects/about/releases", - "destination": "/docs/data-platform/platform-console/maturity-levels", + "destination": "/docs/console/more/feature-maturity", "permanent": true }, { "source": "/docs/data-platform/classic-projects/about/limits-and-status", - "destination": "/docs/data-platform/platform-console/limits", + "destination": "/docs/console/more/feature-maturity", "permanent": true }, { "source": "/docs/data-platform/classic-projects/about", - "destination": "/docs/data-platform/platform-console/about", + "destination": "/docs/console", "permanent": true }, { "source": "/docs/data-platform/classic-projects/contact-support", - "destination": "/docs/data-platform/platform-console/support", + "destination": "/docs/console/more/support", "permanent": true }, { @@ -2724,7 +2724,7 @@ }, { "source": "/docs/data-platform/accelerate/testing", - "destination": "/docs/data-platform/accelerate/evaluating", + "destination": "/docs/accelerate/evaluating", "permanent": true }, { @@ -2784,7 +2784,7 @@ }, { "source": "/docs/concepts/more/telemetry", - "destination": "/docs/orm/tools/prisma-cli#telemetry", + "destination": "/docs/orm/prisma-client/observability-and-logging/opentelemetry-tracing", "permanent": true }, { @@ -3161,7 +3161,7 @@ }, { "source": "/docs/guides/deployment/traditional", - "destination": "/docs/orm/prisma-client/deployment/traditional", + "destination": "/docs/v6/orm/prisma-client/deployment/traditional", "permanent": true }, { @@ -3206,7 +3206,7 @@ }, { "source": "/docs/guides/deployment/edge", - "destination": "/docs/orm/prisma-client/deployment/edge", + "destination": "/docs/orm/prisma-client/deployment/edge/overview", "permanent": true }, { @@ -3621,7 +3621,11 @@ "destination": "/docs/orm/more/releases#roadmap", "permanent": true }, - { "source": "/docs/about/prisma/faq", "destination": "/docs/support", "permanent": true }, + { + "source": "/docs/about/prisma/faq", + "destination": "/docs/console/more/support", + "permanent": true + }, { "source": "/docs/about/prisma/limitations", "destination": "/docs/orm/prisma-schema/data-model/models#limitations", @@ -3696,17 +3700,17 @@ }, { "source": "/docs/platform/concepts/workspaces", - "destination": "/docs/platform/about#workspace", + "destination": "/docs/console/concepts#workspace", "permanent": true }, { "source": "/docs/platform/concepts/projects", - "destination": "/docs/platform/about#project", + "destination": "/docs/console/concepts#project", "permanent": true }, { "source": "/docs/platform/concepts/environments", - "destination": "/docs/platform/about#environment", + "destination": "/docs/console/concepts#resources", "permanent": true }, { "source": "/docs/platform/concepts", "destination": "/docs/console", "permanent": true }, @@ -3926,7 +3930,7 @@ }, { "source": "/docs/postgres/tcp-tunnel", - "destination": "/docs/postgres/database/direct-connections", + "destination": "/docs/postgres/database/connecting-to-your-database", "permanent": true }, { @@ -3936,7 +3940,7 @@ }, { "source": "/docs/postgres/caching", - "destination": "/docs/postgres/database/caching", + "destination": "/docs/accelerate/caching", "permanent": true }, { @@ -4016,7 +4020,7 @@ }, { "source": "/docs/optimize/recommendations/_category_.json", - "destination": "/docs/postgres/query-optimization/recommendations/_category_.json", + "destination": "/docs/query-insights", "permanent": true }, { "source": "/docs/optimize/:path*", "destination": "/docs/query-insights", "permanent": true }, @@ -4047,12 +4051,12 @@ }, { "source": "/docs/postgres/integrations/vscode-agent", - "destination": "/docs/postgres/integrations/vscode-extension#agent-mode", + "destination": "/docs/guides/postgres/vscode#agent-mode", "permanent": true }, { "source": "/docs/postgres/database/tcp-tunnel", - "destination": "/docs/postgres/database/direct-connections", + "destination": "/docs/postgres/database/connecting-to-your-database", "permanent": true }, { @@ -4258,7 +4262,7 @@ }, { "source": "/docs/orm/prisma-client/deployment/accelerate-direct-connections", - "destination": "/docs/postgres/database/direct-connections", + "destination": "/docs/postgres/database/connecting-to-your-database", "permanent": true }, { @@ -4554,7 +4558,7 @@ }, { "source": "/docs/guides/database/prisma-postgres/connect", - "destination": "/docs/postgres/database/direct-connections", + "destination": "/docs/postgres/database/connecting-to-your-database", "permanent": true }, { @@ -5217,7 +5221,7 @@ }, { "source": "/docs/reference/api-reference/prisma-schema-reference/enum", - "destination": "/docs/reference", + "destination": "/docs/orm/reference/prisma-schema-reference#enum", "permanent": true }, { @@ -5257,17 +5261,17 @@ }, { "source": "/docs/prisma-orm/add-to-existing-project/postgresql/page/2", - "destination": "/docs/prisma-orm", + "destination": "/docs/prisma-orm/add-to-existing-project/postgresql", "permanent": true }, { "source": "/docs/prisma-orm/add-to-existing-project/sqlite/page/2", - "destination": "/docs/prisma-orm", + "destination": "/docs/prisma-orm/add-to-existing-project/sqlite", "permanent": true }, { "source": "/docs/reference/tools-and-interfaces/prisma-schema", - "destination": "/docs/reference", + "destination": "/docs/orm/prisma-schema/overview", "permanent": true }, { @@ -5375,7 +5379,7 @@ }, { "source": "/docs/reference/database-connectors/postgresql", - "destination": "/docs/reference", + "destination": "/docs/orm/core-concepts/supported-databases/postgresql", "permanent": true }, { @@ -5400,7 +5404,7 @@ }, { "source": "/docs/concepts/components/prisma-client/working-with-fields/working-with-numeric-fields", - "destination": "/docs/concepts", + "destination": "/docs/orm/reference/prisma-schema-reference", "permanent": true }, { @@ -5410,7 +5414,7 @@ }, { "source": "/docs/reference/api-reference/prisma-schema-reference/datasource", - "destination": "/docs/reference", + "destination": "/docs/orm/reference/prisma-schema-reference#datasource", "permanent": true }, { "source": "/docs/pulse", "destination": "/docs/postgres", "permanent": true }, @@ -5442,7 +5446,7 @@ }, { "source": "/docs/reference/tools-and-interfaces/prisma-schema/data-model", - "destination": "/docs/reference", + "destination": "/docs/orm/prisma-schema/data-model/models", "permanent": true }, { @@ -5452,7 +5456,7 @@ }, { "source": "/docs/concepts/components/prisma-client/working-with-fields/working-with-enum-fields", - "destination": "/docs/concepts", + "destination": "/docs/orm/reference/prisma-schema-reference#enum", "permanent": true }, { @@ -5462,17 +5466,17 @@ }, { "source": "/docs/concepts/components/prisma-client/querying/filtering/data-types", - "destination": "/docs/concepts", + "destination": "/docs/orm/prisma-client/queries/filtering-and-sorting", "permanent": true }, { "source": "/docs/prisma-orm/quickstart", - "destination": "/docs/prisma-orm", + "destination": "/docs/getting-started", "permanent": true }, { "source": "/docs/data-platform/platform-console/limits", - "destination": "/docs/data-platform", + "destination": "/docs/console/more/feature-maturity", "permanent": true }, { @@ -5487,12 +5491,12 @@ }, { "source": "/docs/platform/classic-projects/platform/members", - "destination": "/docs/platform", + "destination": "/docs/console/concepts#workspace", "permanent": true }, { "source": "/docs/reference/service-configuration/prisma.yml/yaml-structure-ufeshusai8", - "destination": "/docs/reference", + "destination": "/docs/orm/reference/prisma-config-reference", "permanent": true }, { @@ -5512,7 +5516,7 @@ }, { "source": "/docs/prisma-client/getting-started", - "destination": "/docs/prisma-client", + "destination": "/docs/orm/prisma-client/setup-and-configuration/introduction", "permanent": true }, { @@ -5527,7 +5531,7 @@ }, { "source": "/docs/about/prisma-docs/docs-components/examples", - "destination": "/docs/about", + "destination": "/docs", "permanent": true }, { @@ -5553,12 +5557,12 @@ }, { "source": "/docs/data-platform/classic-projects/platform/troubleshooting/cannot-edit-schema-file", - "destination": "/docs/data-platform", + "destination": "/docs/console/more/support", "permanent": true }, { "source": "/docs/reference/api-reference/prisma-client-reference/prismaclient", - "destination": "/docs/reference", + "destination": "/docs/orm/reference/prisma-client-reference#prismaclient", "permanent": true }, { @@ -5593,7 +5597,7 @@ }, { "source": "/docs/reference/tools-and-interfaces/introspection", - "destination": "/docs/reference", + "destination": "/docs/orm/prisma-schema/introspection", "permanent": true }, { @@ -5618,7 +5622,7 @@ }, { "source": "/docs/reference/api-reference/error-reference/p1000", - "destination": "/docs/reference", + "destination": "/docs/orm/reference/error-reference#p1000", "permanent": true }, { @@ -5628,12 +5632,12 @@ }, { "source": "/docs/reference/cli-command-reference/database-service/prisma-introspect-jusreo9tn4", - "destination": "/docs/reference", + "destination": "/docs/cli/db/pull", "permanent": true }, { "source": "/docs/reference/tools-and-integration/prisma-cli", - "destination": "/docs/reference", + "destination": "/docs/cli", "permanent": true }, { @@ -5668,7 +5672,7 @@ }, { "source": "/docs/reference/api-reference/prisma-studio", - "destination": "/docs/reference", + "destination": "/docs/studio", "permanent": true }, { @@ -5746,7 +5750,7 @@ }, { "source": "/docs/reference/api-reference/error-reference/p1012", - "destination": "/docs/reference", + "destination": "/docs/orm/reference/error-reference#p1012", "permanent": true }, { @@ -5951,7 +5955,7 @@ }, { "source": "/docs/guide/:path*", "destination": "/docs/guides/:path*", "permanent": true }, { "source": "/docs/-:junk", "destination": "/docs", "permanent": true }, - { "source": "/docs/tutorials/-:junk", "destination": "/docs/tutorials", "permanent": true }, + { "source": "/docs/tutorials/-:junk", "destination": "/docs/guides", "permanent": true }, { "source": "/docs/prisma-orm/:flow/:db/page/:page", "destination": "/docs/prisma-orm/:flow/:db", @@ -5959,12 +5963,12 @@ }, { "source": "/docs/reference/tools-and-integration/:path*", - "destination": "/docs/reference", + "destination": "/docs/cli", "permanent": true }, { "source": "/docs/reference/service-configuration/:path*", - "destination": "/docs/reference", + "destination": "/docs/orm/reference/prisma-config-reference", "permanent": true }, { From 3e031620900b7805e404854da2979933315d9613 Mon Sep 17 00:00:00 2001 From: Carla Goncalves Date: Wed, 29 Apr 2026 07:59:19 +0100 Subject: [PATCH 07/52] Update logo path + structured data --- apps/site/public/images/logo.svg | 1 + apps/site/src/lib/structured-data.ts | 8 ++++++-- 2 files changed, 7 insertions(+), 2 deletions(-) create mode 100644 apps/site/public/images/logo.svg diff --git a/apps/site/public/images/logo.svg b/apps/site/public/images/logo.svg new file mode 100644 index 0000000000..7f475b08b2 --- /dev/null +++ b/apps/site/public/images/logo.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/apps/site/src/lib/structured-data.ts b/apps/site/src/lib/structured-data.ts index 53df270a60..e700a60434 100644 --- a/apps/site/src/lib/structured-data.ts +++ b/apps/site/src/lib/structured-data.ts @@ -42,7 +42,7 @@ export function createSiteStructuredData() { name: "Prisma", url: baseUrl, description, - logo: absoluteUrl("/icons/technologies/prisma.svg"), + logo: absoluteUrl("/images/logo.svg"), sameAs: [ "https://github.com/prisma", "https://twitter.com/prisma", @@ -65,7 +65,11 @@ export function createSiteStructuredData() { }; } -export function createFaqStructuredData(pagePath: string, faqs: FaqEntry[], name: string) { +export function createFaqStructuredData( + pagePath: string, + faqs: FaqEntry[], + name: string, +) { return { "@context": "https://schema.org", "@type": "FAQPage", From 0b0db07e8ccc1b3b1c798171bc5db9f9b1b01c4a Mon Sep 17 00:00:00 2001 From: Carla Goncalves Date: Wed, 29 Apr 2026 08:00:04 +0100 Subject: [PATCH 08/52] Add logo to blog schema --- apps/blog/src/app/(blog)/[slug]/page.tsx | 44 +++++++++++++++++++----- 1 file changed, 35 insertions(+), 9 deletions(-) diff --git a/apps/blog/src/app/(blog)/[slug]/page.tsx b/apps/blog/src/app/(blog)/[slug]/page.tsx index fbcf806972..900d67d070 100644 --- a/apps/blog/src/app/(blog)/[slug]/page.tsx +++ b/apps/blog/src/app/(blog)/[slug]/page.tsx @@ -9,7 +9,11 @@ import { JsonLd } from "@prisma-docs/ui/components/json-ld"; import { FooterNewsletterForm } from "@prisma-docs/ui/components/newsletter"; import { BlogShare } from "@/components/BlogShare"; import { AuthorAvatarGroup } from "@/components/AuthorAvatarGroup"; -import { getBaseUrl, withBlogBasePath, withBlogBasePathForImageSrc } from "@/lib/url"; +import { + getBaseUrl, + withBlogBasePath, + withBlogBasePathForImageSrc, +} from "@/lib/url"; import Link from "next/link"; import type { Metadata } from "next"; @@ -48,6 +52,10 @@ interface BlogPostingSchema { publisher: { "@type": "Organization"; name: string; + logo: { + "@type": "ImageObject"; + url: string; + }; }; } @@ -65,17 +73,25 @@ function toIsoDate(value: unknown): string | undefined { return date.toISOString(); } -function getBlogPostingJsonLd(page: ReturnType): BlogPostingSchema | null { +function getBlogPostingJsonLd( + page: ReturnType, +): BlogPostingSchema | null { if (!page) return null; const title = (page.data.metaTitle ?? page.data.title)?.trim(); - const description = (page.data.metaDescription ?? page.data.description ?? "").trim(); + const description = ( + page.data.metaDescription ?? + page.data.description ?? + "" + ).trim(); if (!title || !description) return null; const canonicalPath = withBlogBasePath(page.url); const canonicalUrl = toAbsoluteUrl(canonicalPath); const imagePath = page.data.metaImagePath ?? page.data.heroImagePath; - const imageUrl = imagePath ? toAbsoluteUrl(withBlogBasePathForImageSrc(imagePath)) : undefined; + const imageUrl = imagePath + ? toAbsoluteUrl(withBlogBasePathForImageSrc(imagePath)) + : undefined; const authorNames = Array.isArray(page.data.authors) ? page.data.authors @@ -86,7 +102,8 @@ function getBlogPostingJsonLd(page: ReturnType): BlogPostin const datePublished = toIsoDate(page.data.date); const dateModified = - toIsoDate((page.data as { lastModified?: unknown }).lastModified) ?? datePublished; + toIsoDate((page.data as { lastModified?: unknown }).lastModified) ?? + datePublished; const jsonLd: BlogPostingSchema = { "@context": "https://schema.org", @@ -98,6 +115,10 @@ function getBlogPostingJsonLd(page: ReturnType): BlogPostin publisher: { "@type": "Organization", name: "Prisma", + logo: { + "@type": "ImageObject", + url: "https://www.prisma.io/logo.png", + }, }, }; @@ -131,7 +152,9 @@ function getBlogPostingJsonLd(page: ReturnType): BlogPostin return jsonLd; } -export default async function Page(props: { params: Promise<{ slug: string }> }) { +export default async function Page(props: { + params: Promise<{ slug: string }>; +}) { const params = await props.params; const page = blog.getPage([params.slug]); @@ -148,7 +171,10 @@ export default async function Page(props: { params: Promise<{ slug: string }> })
{/* Title + meta */}
- + ← Back to Blog

@@ -175,9 +201,9 @@ export default async function Page(props: { params: Promise<{ slug: string }> }) className=" transition-colors border capitalize - border-stroke-neutral-strong + border-stroke-neutral-strong bg-transparent - text-foreground-neutral-weak + text-foreground-neutral-weak hover:bg-background-ppg/50 hover:border-stroke-ppg/50 hover:text-foreground-ppg" From a8c015b679fd18c790707c4a061077d05db0fead Mon Sep 17 00:00:00 2001 From: Carla Goncalves Date: Wed, 29 Apr 2026 08:14:27 +0100 Subject: [PATCH 09/52] Add canonical for query-insights --- apps/site/src/app/query-insights/page.tsx | 61 +++++++++++++++-------- 1 file changed, 40 insertions(+), 21 deletions(-) diff --git a/apps/site/src/app/query-insights/page.tsx b/apps/site/src/app/query-insights/page.tsx index 0ce2f9fedd..643befafb5 100644 --- a/apps/site/src/app/query-insights/page.tsx +++ b/apps/site/src/app/query-insights/page.tsx @@ -7,6 +7,9 @@ export async function generateMetadata(): Promise { title: "Prisma Query Insights", description: "Understand why your database queries are slow, see their real impact in production, and generate a structured AI prompt to improve them.", + alternates: { + canonical: "https://www.prisma.io/query-insights", + }, openGraph: { title: "Prisma Query Insights", description: @@ -48,26 +51,32 @@ export default async function Page() {

- Understand why your database queries are slow, see their real impact in production, and - generate a structured AI prompt to improve them. + Understand why your database queries are slow, see their real impact + in production, and generate a structured AI prompt to improve them.