Prisma 7 merge fix (#7278)

aidankmcalister · ArthurGamby · Arthur Gamby · web-flow · commit d68abc33e5d8 · 2025-11-18T13:49:36.000-05:00
* feat(docs): add youtube embeded link to blog post (#7220) Co-authored-by: Arthur Gamby <arthurgamby@Mac-002.lan> * feat(docs): add quick section to blog after the prompt (#7221) Co-authored-by: Arthur Gamby <arthurgamby@Mac-002.lan> * DC-5242 Astro Better-Auth Guide (#7215) * doc created * nextjs betterauth fixed * guide broken down into manageable steps * image added * Optimised images with calibre/image-actions * image updated * Optimised images with calibre/image-actions * lychee only comments on broken links * config updated * lychee updated based on CR comment * chore: trigger CI checks * ignore gnu * fix: update naming to better-auth DC-6120 * Optimised images with calibre/image-actions * chore: shorten word --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Ankur Datta <64993082+ankur-arch@users.noreply.github.com> * DC-5841 Removed Linkspector (#7231) * removed linkspector * retrigger * retrigger * retrigger * Update label for Prisma Postgres tab (#7236) * fix: content changes for getting started page (#7216) * fix: content changes for getting started page * fix: add redirects * getting started checkpoint * css styles fixed * updates --------- Co-authored-by: Aidan McAlister <aidankmcalister@gmail.com> Co-authored-by: Aidan McAlister <105178005+aidankmcalister@users.noreply.github.com> * DC-5820 AI Agents Served Markdown (#7237) * ai crawler check successful * ai crawlers checked * update * added anthropic * middleware update * improve detection --------- Co-authored-by: Mike Hartington <mikehartington@gmail.com> * Remove MCP server exploration tip (#7241) Removed tip about using Cloudflare's AI Playground for MCP server exploration, as it no longer seems to reliably work. * fix: clear redirect loop (#7250) * Fix typo in environment variables reference (#7193) * Fix typo in environment variables reference * remove duplicate can be --------- Co-authored-by: Ankur Datta <64993082+ankur-arch@users.noreply.github.com> * chore(): add summary sections to top pages (#7228) * DC-6234 Getting Started Page Updates (#7254) * arrow added * quickstart card hover * always copy button added * hover effect on copy button * spcaer added * pointless css removed * updaets * fuctional * revewrt * fixed for mobile * link fix --------- Co-authored-by: Arthur <arthur_gamby@hotmail.fr> Co-authored-by: Arthur Gamby <arthurgamby@Mac-002.lan> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Ankur Datta <64993082+ankur-arch@users.noreply.github.com> Co-authored-by: Petra Donka <donkapetra@gmail.com> Co-authored-by: Mike Hartington <mikehartington@gmail.com> Co-authored-by: Odysseus Zhang <b1fzhang@gmail.com> Co-authored-by: Mike Hartington <mhartington@users.noreply.github.com>
diff --git a/content/100-getting-started/index.mdx b/content/100-getting-started/index.mdx
@@ -21,7 +21,8 @@ import {
   SignalStream,
   PrismaPostgres,
   SquareLogo,
-  QuickstartLinkCard
+  QuickstartLinkCard,
+  Spacer
 } from '@site/src/components/GettingStarted';
 
 
@@ -33,7 +34,7 @@ import {
 
 [**Prisma ORM**](/orm/overview/introduction/what-is-prisma) is an open-source ORM that provides fast, type-safe access to Postgres, MySQL, SQLite, and more databases, and runs smoothly across Node.js, Bun, and Deno.
 
-```terminal
+```terminal always-copy
 npx prisma init --db
 ```
 </BorderBox >
@@ -43,7 +44,7 @@ npx prisma init --db
 
 [**Prisma Postgres**](/postgres) is a fully managed PostgreSQL database that scales to zero, integrates with Prisma ORM and Prisma Studio, and includes a generous free tier.
 
-```terminal
+```terminal always-copy
 npx create-db
 ```
 </BorderBox >
@@ -53,7 +54,7 @@ npx create-db
 <br/>
 
 <QuickstartLinkCard
-    title="Quickstart →"
+    title="Quickstart"
     highlight="#16A394"
     link="/getting-started/prisma-orm/quickstart/prisma-postgres"
 >
@@ -111,35 +112,35 @@ The fastest way to set Prisma ORM up with a ready-to-use database.
 <br/>
 <br/>
 
-### <Plug color="#16A394" width="24" height="24" /> Using Prisma Postgres with other tools?
+  {/* ### <Plug color="#16A394" width="24" height="24" /> Using Prisma Postgres with other tools?
 
 You can also use Prisma Postgres with different tools or ORMs. Pick one of the options below to see how to connect.
 
 <List>
       <SquareLogo
-        url="/getting-started/prisma-postgres/quickstart/kysely"
+        url="/getting-started/setup-prisma/start-from-scratch/relational-databases-typescript-postgresql"
         image={'/img/technologies/kysely.svg'}
         tech="Kysely"
       />
       <SquareLogo
-        url="/getting-started/prisma-postgres/quickstart/drizzle-orm"
+        url="/getting-started/setup-prisma/start-from-scratch/relational-databases-typescript-mysql"
         image={'/img/technologies/drizzle.svg'}
         tech="Drizzle"
       />
-      {/* <SquareLogo
-        url="/getting-started/prisma-postgres/quickstart/typeorm"
+      <SquareLogo
+        url="/getting-started/setup-prisma/start-from-scratch/relational-databases-typescript-sqlserver"
         image={'/img/technologies/sequelize.svg'}
         tech="Sequelize"
-      /> */}
+      />
       <SquareLogo
-        url="/getting-started/prisma-postgres/quickstart/typeorm"
+        url="/getting-started/setup-prisma/start-from-scratch/relational-databases-typescript-planetscale"
         image={'/img/technologies/typeorm.svg'}
         tech="TypeORM"
       />
 </List>
 
 <br/>
-<br/>
+<br/> */}
 
 ### <Plus color="#16A394" width="24" height="24" /> Add Prisma to your favorite framework?
 
@@ -179,3 +180,4 @@ Working with **Next.js**, **Remix**, or another framework? You can easily add Pr
       />
 </List>
 
+<Spacer size="120px" />
diff --git a/content/200-orm/050-overview/500-databases/800-sql-server/020-sql-server-local.mdx b/content/200-orm/050-overview/500-databases/800-sql-server/020-sql-server-local.mdx
@@ -4,6 +4,11 @@ metaTitle: 'SQL Server on Windows'
 metaDescription: 'Set up and configure SQL Server on Windows.'
 ---
 
+:::info Quick summary
+Learn how to set up and configure Microsoft SQL Server locally on Windows for use with Prisma ORM.
+:::
+
+
 <TopBlock>
 
 To run a Microsoft SQL Server locally on a Windows machine:
diff --git a/content/200-orm/050-overview/500-databases/800-sql-server/030-sql-server-docker.mdx b/content/200-orm/050-overview/500-databases/800-sql-server/030-sql-server-docker.mdx
@@ -4,6 +4,11 @@ metaTitle: 'SQL Server  on Docker'
 metaDescription: 'Download and use the Microsoft SQL Server Docker image.'
 ---
 
+:::info Quick summary
+This guide provides a quick overview on setting up and running Microsoft SQL Server in a Docker container, including pulling the image, starting the server, connecting, and creating a test database.
+:::
+
+
 <TopBlock>
 
 To run a Microsoft SQL Server container image with Docker:
diff --git a/content/200-orm/100-prisma-schema/20-data-model/20-relations/100-one-to-one-relations.mdx b/content/200-orm/100-prisma-schema/20-data-model/20-relations/100-one-to-one-relations.mdx
@@ -4,6 +4,11 @@ metaDescription: How to define and work with one-to-one relations in Prisma.
 tocDepth: 3
 ---
 
+:::info Quick summary
+Learn how to define and use one-to-one (1-1) relations in your Prisma schema, including modeling choices and key concepts.
+:::
+
+
 <TopBlock>
 
 This page introduces one-to-one relations and explains how to use them in your Prisma schema.
diff --git a/content/200-orm/100-prisma-schema/20-data-model/20-relations/300-many-to-many-relations.mdx b/content/200-orm/100-prisma-schema/20-data-model/20-relations/300-many-to-many-relations.mdx
@@ -4,6 +4,10 @@ metaDescription: How to define and work with many-to-many relations in Prisma.
 tocDepth: 3
 ---
 
+:::info Quick summary
+This guide explains how to define and use many-to-many (m-n) relationships in Prisma, with examples for both relational databases and MongoDB.
+:::
+
 <TopBlock>
 
 Many-to-many (m-n) relations refer to relations where zero or more records on one side of the relation can be connected to zero or more records on the other side.
diff --git a/content/200-orm/100-prisma-schema/20-data-model/20-relations/410-referential-actions/100-special-rules-for-referential-actions.mdx b/content/200-orm/100-prisma-schema/20-data-model/20-relations/410-referential-actions/100-special-rules-for-referential-actions.mdx
@@ -5,6 +5,11 @@ metaDescription: 'Circular references or multiple cascade paths can cause valida
 tocDepth: 3
 ---
 
+:::info Quick summary
+This page explains special rules and common issues when using referential actions with SQL Server and MongoDB, including how to avoid cycles and multiple cascade paths.
+:::
+
+
 <TopBlock>
 
 Some databases have specific requirements that you should consider if you are using referential actions.
diff --git a/content/200-orm/200-prisma-client/000-setup-and-configuration/050-databases-connections/100-connection-management.mdx b/content/200-orm/200-prisma-client/000-setup-and-configuration/050-databases-connections/100-connection-management.mdx
@@ -5,6 +5,11 @@ metaDescription: 'This page explains how database connections are handled with P
 tocDepth: 3
 ---
 
+:::info Quick summary
+This page explains how Prisma Client manages database connections, including how and when to use the `$connect()` and `$disconnect()` methods, connection pooling behavior, and best practices for both long-running and serverless environments.
+:::
+
+
 <TopBlock>
 
 `PrismaClient` connects and disconnects from your data source using the following two methods:
diff --git a/content/200-orm/200-prisma-client/000-setup-and-configuration/050-databases-connections/115-connection-pool.mdx b/content/200-orm/200-prisma-client/000-setup-and-configuration/050-databases-connections/115-connection-pool.mdx
@@ -5,6 +5,11 @@ tocDepth: 4
 toc_max_heading_level: 4
 ---
 
+:::info Quick summary
+This page explains how Prisma ORM manages database connections using a connection pool, and how you can configure limits and timeouts for optimal performance.
+:::
+
+
 The query engine manages a **connection pool** of database connections. The pool is created when Prisma Client opens the _first_ connection to the database, which can happen in one of two ways:
 
 - By [explicitly calling `$connect()`](/orm/prisma-client/setup-and-configuration/databases-connections/connection-management#connect) _or_
diff --git a/content/200-orm/200-prisma-client/000-setup-and-configuration/050-databases-connections/200-pgbouncer.mdx b/content/200-orm/200-prisma-client/000-setup-and-configuration/050-databases-connections/200-pgbouncer.mdx
@@ -1,6 +1,7 @@
 ---
 title: Configure Prisma Client with PgBouncer
 metaTitle: Configure Prisma Client with PgBouncer
+metaDescription: 'Configure Prisma Client with PgBouncer and other poolers: when to use pgbouncer=true, required transaction mode, prepared statements, and Prisma Migrate workarounds.'
 ---
 
 An external connection pooler like PgBouncer holds a connection pool to the database, and proxies incoming client connections by sitting between Prisma Client and the database. This reduces the number of processes a database has to handle at any given time.
diff --git a/content/200-orm/200-prisma-client/300-client-extensions/140-shared-extensions/100-permit-rbac.mdx b/content/200-orm/200-prisma-client/300-client-extensions/140-shared-extensions/100-permit-rbac.mdx
@@ -6,6 +6,11 @@ toc_max_heading_level: 4
 ---
 
 
+:::info Quick summary
+This page explains how to implement fine-grained authorization (FGA) in Prisma ORM applications using the `@permitio/permit-prisma` extension. It introduces different access control models—RBAC, ABAC, and ReBAC—supported by Permit.io, and guides you on choosing the right model to protect your database operations with precise, programmable permissions.
+
+:::
+
 
 Database operations often require careful control over who can access or modify which data. While Prisma ORM excels at data modeling and database access, it doesn't include built-in authorization capabilities. This guide shows how to implement fine-grained authorization in your Prisma applications using the `@permitio/permit-prisma` extension.
 
diff --git a/content/200-orm/200-prisma-client/500-deployment/201-serverless/400-deploy-to-aws-lambda.mdx b/content/200-orm/200-prisma-client/500-deployment/201-serverless/400-deploy-to-aws-lambda.mdx
@@ -6,7 +6,9 @@ tocDepth: 3
 ---
 
 
+:::info Quick summary
 This guide explains how to avoid common issues when deploying a project using Prisma ORM to [AWS Lambda](https://aws.amazon.com/lambda/).
+:::
 
 <details>
 <summary>Questions answered in this page</summary>
diff --git a/content/200-orm/200-prisma-client/500-deployment/301-edge/450-deploy-to-cloudflare.mdx b/content/200-orm/200-prisma-client/500-deployment/301-edge/450-deploy-to-cloudflare.mdx
@@ -6,7 +6,10 @@ sidebar_label: Deploy to Cloudflare
 tocDepth: 3
 ---
 
+
+:::info Quick summary
 This page covers everything you need to know to deploy an app with Prisma ORM to a [Cloudflare Worker](https://developers.cloudflare.com/workers/) or to [Cloudflare Pages](https://developers.cloudflare.com/pages).
+:::
 
 <details>
 <summary>Questions answered in this page</summary>
diff --git a/content/200-orm/500-reference/300-environment-variables-reference.mdx b/content/200-orm/500-reference/300-environment-variables-reference.mdx
@@ -194,7 +194,7 @@ This environment variable is available since version `4.16.0`
 
 :::
 
-`PRISMA_ENGINES_CHECKSUM_IGNORE_MISSING` can be can be set to a truthy value to ignore problems around downloading & verifying the integrity (via a checksum file) of the Prisma ORM engines.
+`PRISMA_ENGINES_CHECKSUM_IGNORE_MISSING` can be set to a truthy value to ignore problems around downloading & verifying the integrity (via a checksum file) of the Prisma ORM engines.
 This is particularly useful when deploying to an offline system environment where the checksum file cannot be downloaded.
 
 ```env
@@ -225,7 +225,7 @@ PRISMA_QUERY_ENGINE_BINARY=custom/query-engine-<target>
 For Prisma CLI it allows you to define the query engine file to be used.  
 For Prisma Client, on build time (during `prisma generate`), it defines where the query engine file will be copied from into Prisma Client. At run time (when using the generated Client) it can be used to define the specific query engine file to be used instead of the included one.
 
-Note: This can only have an effect if the engine type of CLI or Client are set to `binary`. If the engine type is `library` (the default), use PRISMA_QUERY_ENGINE_LIBARY instead.
+Note: This can only have an effect if the engine type of CLI or Client are set to `binary`. If the engine type is `library` (the default), use PRISMA_QUERY_ENGINE_LIBRARY instead.
 
 #### `PRISMA_QUERY_ENGINE_LIBRARY`
 
diff --git a/content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx b/content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx
@@ -284,7 +284,7 @@ async function main() {
 
 ### Client middleware has been removed
 
-The client middleware API has been removed. If possible, use [Client Extensions](orm/prisma-client/client-extensions). 
+The client middleware API has been removed. If possible, use [Client Extensions](/orm/prisma-client/client-extensions). 
 
 ```ts
 // ❌ Old (removed)
diff --git a/content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/900-codemods.mdx b/content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/900-codemods.mdx
@@ -4,6 +4,11 @@ metaTitle: 'Codemods (Guides)'
 metaDescription: 'Use codemods to upgrade your codebase as Prisma ORM evolves.'
 ---
 
+:::info Quick summary
+This page explains how to use Prisma's codemods to automatically update your codebase during major version upgrades. Learn about installation, usage commands, available code transformations, and options for safely refactoring your projects.
+:::
+
+
 <TopBlock>
 
 The `@prisma/codemods` package helps you to upgrade your codebase as Prisma ORM evolves.
diff --git a/content/200-orm/800-more/300-upgrade-guides/800-upgrade-from-prisma-1/02-schema-incompatibilities-postgresql.mdx b/content/200-orm/800-more/300-upgrade-guides/800-upgrade-from-prisma-1/02-schema-incompatibilities-postgresql.mdx
@@ -7,6 +7,11 @@ dbSwitcher: ['postgresql', 'mysql']
 pagination_next: orm/more/upgrade-guides/upgrade-from-prisma-1/upgrading-the-prisma-layer-postgresql
 slugSwitch: /orm/more/upgrade-guides/upgrade-from-prisma-1/schema-incompatibilities-
 ---
+
+:::info Quick summary
+This guide explains common schema incompatibility issues you may encounter when upgrading from Prisma 1 to Prisma ORM (v2+) with PostgreSQL, and how to address them.
+:::
+
  
 ## Overview
 
diff --git a/src/components/GettingStarted/index.tsx b/src/components/GettingStarted/index.tsx
@@ -159,11 +159,16 @@ export const QuickstartLinkCard = ({ icon, title, desc, link, highlight, childre
     <Link
       to={link}
       ref={linkCardRef}
-      className={clsx(styles.linkCardWrapper, highlight && styles.linkCardHighlight)}
+      className={clsx(
+        styles.linkCardWrapper,
+        highlight && styles.linkCardHighlight,
+        styles.quickstartCard
+      )}
     >
       <div className={styles.title}>
         {icon && <Icon icon={icon} btn="left" size="18px" />}
         <h2>{title}</h2>
+        <Icon icon="fa-regular fa-arrow-right" size="18px" />
       </div>
       {children ?? <p>{desc}</p>}
     </Link>
@@ -210,3 +215,5 @@ export const List = ({ children, framed, split, ...props }) => (
     {children}
   </div>
 );
+
+export const Spacer = ({ size }: { size: string }) => <div style={{ height: size }} />;
diff --git a/src/css/gettingStarted.module.scss b/src/css/gettingStarted.module.scss
@@ -58,6 +58,20 @@
       }
     }
   }
+
+  // Copy button styles specific to Getting Started page
+  :global(.theme-code-block) {
+    button[class*="copyButton"] {
+      background: var(--border-primary, #2d3748);
+      color: var(--Text-text-secondary, #e2e8f0);
+      transition: background 0.2s ease;
+      border: none;
+      margin-top: 4px;
+      &:hover {
+        background: var(--Text-text-disabled, #4a5568);
+      }
+    }
+  }
 }
 
 .boxTitle {
@@ -89,8 +103,27 @@
     border: 1px solid var(--surface-brand-default);
     background: var(--surface-brand-light);
   }
+  &.quickstartCard {
+    transition:
+      border 0.2s ease,
+      background-color 0.2s ease;
+    &:hover {
+      border: 1px solid var(--border-color-active, #154f47);
+    }
+    .title {
+      gap: 8px;
+      i:last-child {
+        transition: transform 0.2s ease;
+      }
+    }
+    &:hover .title i:last-child {
+      transform: translateX(8px);
+    }
+  }
   .title {
     display: inline-flex;
+    align-items: center;
+    gap: 8px;
     h2 {
       font-family: Barlow;
       border-bottom: 1px solid var(--main-font-color);
@@ -157,6 +190,10 @@
   display: flex;
   justify-content: flex-start;
 
+  @media (max-width: 1400px) {
+    flex-wrap: wrap;
+  }
+
   &:not(.framedList) {
     @media (min-width: 1400px) {
       grid-template-columns: repeat(7, auto);
diff --git a/src/theme/CodeBlock/Content/String.tsx b/src/theme/CodeBlock/Content/String.tsx
@@ -97,7 +97,11 @@ export default function CodeBlockString({
             />
           )}
           {!metastring?.includes("no-copy") && (
-            <CopyButton className={styles.codeButton} code={code} />
+            <CopyButton
+              className={styles.codeButton}
+              code={code}
+              alwaysVisible={metastring?.includes("always-copy")}
+            />
           )}
         </div>
       </div>
diff --git a/src/theme/CodeBlock/CopyButton/index.js b/src/theme/CodeBlock/CopyButton/index.js
@@ -5,7 +5,7 @@ import { translate } from "@docusaurus/Translate";
 import IconCopy from "@theme/Icon/Copy";
 import IconSuccess from "@theme/Icon/Success";
 import styles from "./styles.module.css";
-export default function CopyButton({ code, className }) {
+export default function CopyButton({ code, className, alwaysVisible = false }) {
   const [isCopied, setIsCopied] = useState(false);
   const copyTimeout = useRef(undefined);
   const handleCopyCode = useCallback(() => {
@@ -41,7 +41,8 @@ export default function CopyButton({ code, className }) {
         "clean-btn",
         className,
         styles.copyButton,
-        isCopied && styles.copyButtonCopied
+        isCopied && styles.copyButtonCopied,
+        alwaysVisible && styles.copyButtonAlwaysVisible
       )}
       onClick={handleCopyCode}
     >
diff --git a/src/theme/CodeBlock/CopyButton/styles.module.css b/src/theme/CodeBlock/CopyButton/styles.module.css
@@ -2,6 +2,14 @@
   opacity: 1 !important;
 }
 
+.copyButtonAlwaysVisible {
+  opacity: 0.5 !important;
+  transition: opacity 0.2s ease;
+  &:hover {
+    opacity: 1 !important;
+  }
+}
+
 .copyButtonIcons {
   position: relative;
   width: 1.125rem;
