Merge branch 'main' into fix/DC-3193-show-query-results-color

Author: carlagn

content/200-orm/050-overview/500-databases/880-supabase.mdx

@@ -18,11 +18,11 @@ To learn more about Supabase, you can check out their architecture [here](https:
 
 Many aspects of using Prisma ORM with Supabase are just like using Prisma ORM with any other relational database. You can still:
 
-- model your database with the [Prisma Schema Language](/orm/prisma-schema)
-- use Prisma ORM's existing [`postgresql` database connector](/orm/overview/databases/postgresql) in your schema, along with the [connection string Supabase provides you](https://supabase.com/docs/guides/database/connecting-to-postgres#connecting-to-external-libraries-and-tools)
-- use [Introspection](/orm/prisma-schema/introspection) for existing projects if you already have a database schema in Supabase
-- use [`db push`](/orm/prisma-migrate/workflows/prototyping-your-schema) to push changes in your schema to Supabase
-- use [Prisma Client](/orm/prisma-client) in your application to talk to the database server at Supabase
+- Model your database with the [Prisma Schema Language](/orm/prisma-schema)
+- Use Prisma ORM's existing [`postgresql` database connector](/orm/overview/databases/postgresql) in your schema, along with the [connection string Supabase provides you](https://supabase.com/docs/guides/database/connecting-to-postgres#connecting-to-external-libraries-and-tools)
+- Use [Introspection](/orm/prisma-schema/introspection) for existing projects if you already have a database schema in Supabase
+- Use [`db push`](/orm/prisma-migrate/workflows/prototyping-your-schema) to push changes in your schema to Supabase
+- Use [Prisma Client](/orm/prisma-client) in your application to talk to the database server at Supabase
 
 ## Specific considerations
 
@@ -33,7 +33,19 @@ If you'd like to use the [connection pooling feature](https://supabase.com/docs/
 DATABASE_URL="postgres://postgres.[your-supabase-project]:[password]@aws-0-[aws-region].pooler.supabase.com:6543/postgres?pgbouncer=true"
 ```
 
-If you would like to use the Prisma CLI in order to perform other actions on your database (e.g. migrations) you will need to add a `DIRECT_URL` environment variable to use in the `datasource.directUrl` property so that the CLI can bypass Supavisor:
+Supabase provides three types of connection strings for each database:
+
+1. **Direct Database Connection string** – `postgresql://postgres:password@db.[your-project-ref].supabase.co:5432/postgres`
+
+2. **Transaction Pooler Connection string** – `postgresql://postgres.[your-project-ref]:password@aws-0-[region].pooler.supabase.com:6543/postgres`
+
+3. **Session Pooler Connection string** – `postgresql://postgres.[your-project-ref]:password@aws-0-[region].pooler.supabase.com:5432/postgres`
+
+If you would like to use the Prisma CLI in order to perform other actions on your database (e.g. migrations), your setup depends on the connection string used:
+
+- If your `DATABASE_URL` uses the Transaction Pooler (connection string 2), you must provide a `DIRECT_URL` with either the Direct Database (1) or Session Pooler (3) connection string in order for Prisma Migrate to work.
+
+- If your `DATABASE_URL` already uses the Session Pooler (connection string 3), you do not need to provide a `DIRECT_URL`. Prisma Migrate will work without it.
 
 ```env file=.env highlight=4-5;add showLineNumbers
 # Connect to Supabase via connection pooling with Supavisor.
@@ -42,6 +54,8 @@ DATABASE_URL="postgres://postgres.[your-supabase-project]:[password]@aws-0-[aws-
 //add-start
 # Direct connection to the database. Used for migrations.
 DIRECT_URL="postgres://postgres.[your-supabase-project]:[password]@aws-0-[aws-region].pooler.supabase.com:5432/postgres"
+# or
+DIRECT_URL="postgresql://postgres:password@db.[your-project-ref].supabase.co:5432/postgres"
 //add-end
 ```
 

content/250-postgres/1200-more/800-known-limitations.mdx

@@ -19,6 +19,6 @@ Prisma Postgres will be gradually rolled out in new regions.
 
 Prisma Postgres _currently_ has a fixed connection limit of `10` that cannot be adjusted. 
 
-### Postgres extensions are not supported
+### Limited Postgres extensions support
 
-Prisma Postgres currently lacks support for Postgres extensions. This is a temporary limitation, and we plan to add support soon. Let us know which extensions you need by filling out [this form](https://pris.ly/i-want-extensions).
+Prisma Postgres currently supports only the PostgreSQL extensions that come pre-installed with the standard PostgreSQL distribution. We are actively working on expanding support to include a broader range of community maintained extensions. Let us know which ones you'd like us to prioritize by filling out [this form](https://pris.ly/i-want-extensions).

sidebars.ts

@@ -440,7 +440,12 @@ const sidebars: SidebarsConfig = {
           label: "Integration Solutions",
           collapsed: false,
           collapsible: false,
-          items: ["guides/clerk-nextjs", "guides/shopify", "guides/permit-io-access-control"].sort(),
+          items: [
+            "guides/clerk-nextjs",
+            "guides/shopify",
+            "guides/permit-io-access-control",
+            "guides/betterauth-nextjs",
+          ].sort(),
         },
         {
           type: "category",