[pull] master from supabase:master

apps/docs/app/guides/ai/[[...slug]]/page.tsx

@@ -4,8 +4,8 @@ import {
   genGuidesStaticParams,
 } from '~/features/docs/GuidesMdx.utils'
 import { GuideTemplate } from '~/features/docs/GuidesMdx.template'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
+import { getEmptyArray } from '~/features/helpers.fn'
 
 type Params = { slug?: string[] }
 
@@ -17,7 +17,7 @@ const AiGuidePage = async (props: { params: Promise<Params> }) => {
   return <GuideTemplate {...data!} />
 }
 
-const generateStaticParams = genGuidesStaticParams('ai')
+const generateStaticParams = IS_PROD ? genGuidesStaticParams('ai') : getEmptyArray
 const generateMetadata = genGuideMeta((params: { slug?: string[] }) =>
   getGuidesMarkdown(['ai', ...(params.slug ?? [])])
 )

apps/docs/app/guides/api/[[...slug]]/page.tsx

@@ -4,8 +4,8 @@ import {
   genGuidesStaticParams,
 } from '~/features/docs/GuidesMdx.utils'
 import { GuideTemplate } from '~/features/docs/GuidesMdx.template'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
+import { getEmptyArray } from '~/features/helpers.fn'
 
 type Params = { slug?: string[] }
 
@@ -17,7 +17,7 @@ const ApiGuidePage = async (props: { params: Promise<Params> }) => {
   return <GuideTemplate {...data!} />
 }
 
-const generateStaticParams = genGuidesStaticParams('api')
+const generateStaticParams = IS_PROD ? genGuidesStaticParams('api') : getEmptyArray
 const generateMetadata = genGuideMeta((params: { slug?: string[] }) =>
   getGuidesMarkdown(['api', ...(params.slug ?? [])])
 )

apps/docs/app/guides/auth/[[...slug]]/page.tsx

@@ -4,8 +4,8 @@ import {
   genGuidesStaticParams,
 } from '~/features/docs/GuidesMdx.utils'
 import { GuideTemplate } from '~/features/docs/GuidesMdx.template'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
+import { getEmptyArray } from '~/features/helpers.fn'
 
 type Params = { slug?: string[] }
 
@@ -17,7 +17,7 @@ const AuthGuidePage = async (props: { params: Promise<Params> }) => {
   return <GuideTemplate {...data!} />
 }
 
-const generateStaticParams = genGuidesStaticParams('auth')
+const generateStaticParams = IS_PROD ? genGuidesStaticParams('auth') : getEmptyArray
 const generateMetadata = genGuideMeta((params: { slug?: string[] }) =>
   getGuidesMarkdown(['auth', ...(params.slug ?? [])])
 )

apps/docs/app/guides/auth/troubleshooting/page.tsx

@@ -0,0 +1,15 @@
+import SectionTroubleshootingPage, {
+  generateSectionTroubleshootingMetadata,
+} from '~/features/docs/TroubleshootingSection.page'
+
+export default async function AuthTroubleshootingPage() {
+  return (
+    <SectionTroubleshootingPage
+      topic="auth"
+      sectionName="Auth"
+      description="Search or browse troubleshooting guides for common authentication issues, including login problems, session management, and provider configuration."
+    />
+  )
+}
+
+export const metadata = generateSectionTroubleshootingMetadata('auth', 'Auth')

apps/docs/app/guides/cron/[[...slug]]/page.tsx

@@ -4,8 +4,8 @@ import {
   genGuidesStaticParams,
 } from '~/features/docs/GuidesMdx.utils'
 import { GuideTemplate } from '~/features/docs/GuidesMdx.template'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
+import { getEmptyArray } from '~/features/helpers.fn'
 
 type Params = { slug?: string[] }
 
@@ -17,7 +17,7 @@ const CronGuidePage = async (props: { params: Promise<Params> }) => {
   return <GuideTemplate {...data!} />
 }
 
-const generateStaticParams = genGuidesStaticParams('cron')
+const generateStaticParams = IS_PROD ? genGuidesStaticParams('cron') : getEmptyArray
 const generateMetadata = genGuideMeta((params: { slug?: string[] }) =>
   getGuidesMarkdown(['cron', ...(params.slug ?? [])])
 )

apps/docs/app/guides/database/[[...slug]]/page.tsx

@@ -4,8 +4,8 @@ import {
   genGuidesStaticParams,
 } from '~/features/docs/GuidesMdx.utils'
 import { GuideTemplate } from '~/features/docs/GuidesMdx.template'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
+import { getEmptyArray } from '~/features/helpers.fn'
 
 type Params = { slug?: string[] }
 
@@ -17,7 +17,7 @@ const DatabaseGuidePage = async (props: { params: Promise<Params> }) => {
   return <GuideTemplate {...data!} />
 }
 
-const generateStaticParams = genGuidesStaticParams('database')
+const generateStaticParams = IS_PROD ? genGuidesStaticParams('database') : getEmptyArray
 const generateMetadata = genGuideMeta((params: { slug?: string[] }) =>
   getGuidesMarkdown(['database', ...(params.slug ?? [])])
 )

apps/docs/app/guides/database/extensions/wrappers/[[...slug]]/page.tsx

@@ -22,8 +22,7 @@ import { removeTitle } from '~/lib/mdx/plugins/remarkRemoveTitle'
 import remarkPyMdownTabs from '~/lib/mdx/plugins/remarkTabs'
 import { octokit } from '~/lib/octokit'
 import { SerializeOptions } from '~/types/next-mdx-remote-serialize'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
 
 // We fetch these docs at build time from an external repo
 const org = 'supabase'
@@ -416,6 +415,10 @@ const urlTransform: UrlTransformFunction = (url) => {
 }
 
 const generateStaticParams = async () => {
+  if (IS_PROD) {
+    return []
+  }
+
   const mdxPaths = await genGuidesStaticParams('database/extensions/wrappers')()
   const federatedPaths = pageMap.map(({ slug }) => ({
     slug: [slug],

apps/docs/app/guides/database/troubleshooting/page.tsx

@@ -0,0 +1,15 @@
+import SectionTroubleshootingPage, {
+  generateSectionTroubleshootingMetadata,
+} from '~/features/docs/TroubleshootingSection.page'
+
+export default async function DatabaseTroubleshootingPage() {
+  return (
+    <SectionTroubleshootingPage
+      topic="database"
+      sectionName="Database"
+      description="Search or browse troubleshooting guides for common database issues, including connection problems, query optimization, and configuration."
+    />
+  )
+}
+
+export const metadata = generateSectionTroubleshootingMetadata('database', 'Database')

apps/docs/app/guides/deployment/[[...slug]]/page.tsx

@@ -4,8 +4,8 @@ import {
   genGuidesStaticParams,
 } from '~/features/docs/GuidesMdx.utils'
 import { GuideTemplate } from '~/features/docs/GuidesMdx.template'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
+import { getEmptyArray } from '~/features/helpers.fn'
 
 type Params = { slug?: string[] }
 
@@ -17,7 +17,7 @@ const DeploymentGuidePage = async (props: { params: Promise<Params> }) => {
   return <GuideTemplate {...data!} />
 }
 
-const generateStaticParams = genGuidesStaticParams('deployment')
+const generateStaticParams = IS_PROD ? genGuidesStaticParams('deployment') : getEmptyArray
 const generateMetadata = genGuideMeta((params: { slug?: string[] }) =>
   getGuidesMarkdown(['deployment', ...(params.slug ?? [])])
 )

apps/docs/app/guides/deployment/terraform/[[...slug]]/page.tsx

@@ -17,8 +17,8 @@ import {
   terraformDocsRepo,
 } from '../terraformConstants'
 import { SerializeOptions } from '~/types/next-mdx-remote-serialize'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
+import { getEmptyArray } from '~/features/helpers.fn'
 
 // Each external docs page is mapped to a local page
 const pageMap = [
@@ -142,7 +142,9 @@ const getContent = async ({ slug }: Params) => {
   }
 }
 
-const generateStaticParams = async () => pageMap.map(({ slug }) => ({ slug: slug ? [slug] : [] }))
+const generateStaticParams = IS_PROD
+  ? async () => pageMap.map(({ slug }) => ({ slug: slug ? [slug] : [] }))
+  : getEmptyArray
 const generateMetadata = genGuideMeta(getContent)
 
 export default TerraformDocs

apps/docs/app/guides/functions/[[...slug]]/page.tsx

@@ -4,8 +4,8 @@ import {
   genGuidesStaticParams,
 } from '~/features/docs/GuidesMdx.utils'
 import { GuideTemplate } from '~/features/docs/GuidesMdx.template'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
+import { getEmptyArray } from '~/features/helpers.fn'
 
 type Params = { slug?: string[] }
 
@@ -17,7 +17,7 @@ const FunctionsGuidePage = async (props: { params: Promise<Params> }) => {
   return <GuideTemplate {...data!} />
 }
 
-const generateStaticParams = genGuidesStaticParams('functions')
+const generateStaticParams = IS_PROD ? genGuidesStaticParams('functions') : getEmptyArray
 const generateMetadata = genGuideMeta((params: { slug?: string[] }) =>
   getGuidesMarkdown(['functions', ...(params.slug ?? [])])
 )

apps/docs/app/guides/functions/troubleshooting/page.tsx

@@ -0,0 +1,15 @@
+import SectionTroubleshootingPage, {
+  generateSectionTroubleshootingMetadata,
+} from '~/features/docs/TroubleshootingSection.page'
+
+export default async function FunctionsTroubleshootingPage() {
+  return (
+    <SectionTroubleshootingPage
+      topic="functions"
+      sectionName="Edge Functions"
+      description="Search or browse troubleshooting guides for common Edge Functions issues, including deployment problems, runtime errors, and environment configuration."
+    />
+  )
+}
+
+export const metadata = generateSectionTroubleshootingMetadata('functions', 'Edge Functions')

apps/docs/app/guides/getting-started/[[...slug]]/page.tsx

@@ -4,8 +4,8 @@ import {
   genGuidesStaticParams,
 } from '~/features/docs/GuidesMdx.utils'
 import { GuideTemplate } from '~/features/docs/GuidesMdx.template'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
+import { getEmptyArray } from '~/features/helpers.fn'
 
 type Params = { slug?: string[] }
 
@@ -17,7 +17,7 @@ const GettingStartedGuidePage = async (props: { params: Promise<Params> }) => {
   return <GuideTemplate {...data!} />
 }
 
-const generateStaticParams = genGuidesStaticParams('getting-started')
+const generateStaticParams = IS_PROD ? genGuidesStaticParams('getting-started') : getEmptyArray
 const generateMetadata = genGuideMeta((params: { slug?: string[] }) =>
   getGuidesMarkdown(['getting-started', ...(params.slug ?? [])])
 )

apps/docs/app/guides/graphql/[[...slug]]/page.tsx

@@ -10,8 +10,8 @@ import remarkMkDocsAdmonition from '~/lib/mdx/plugins/remarkAdmonition'
 import { removeTitle } from '~/lib/mdx/plugins/remarkRemoveTitle'
 import remarkPyMdownTabs from '~/lib/mdx/plugins/remarkTabs'
 import { SerializeOptions } from '~/types/next-mdx-remote-serialize'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
+import { getEmptyArray } from '~/features/helpers.fn'
 
 // We fetch these docs at build time from an external repo
 const org = 'supabase'
@@ -190,7 +190,9 @@ const urlTransform: UrlTransformFunction = (url) => {
   }
 }
 
-const generateStaticParams = async () => pageMap.map(({ slug }) => ({ slug: slug ? [slug] : [] }))
+const generateStaticParams = IS_PROD
+  ? async () => pageMap.map(({ slug }) => ({ slug: slug ? [slug] : [] }))
+  : getEmptyArray
 const generateMetadata = genGuideMeta(getContent)
 
 export default PGGraphQLDocs

apps/docs/app/guides/integrations/[[...slug]]/page.tsx

@@ -4,8 +4,8 @@ import {
   genGuidesStaticParams,
 } from '~/features/docs/GuidesMdx.utils'
 import { GuideTemplate } from '~/features/docs/GuidesMdx.template'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
+import { getEmptyArray } from '~/features/helpers.fn'
 
 type Params = { slug?: string[] }
 
@@ -17,7 +17,7 @@ const IntegrationsGuidePage = async (props: { params: Promise<Params> }) => {
   return <GuideTemplate {...data!} />
 }
 
-const generateStaticParams = genGuidesStaticParams('integrations')
+const generateStaticParams = IS_PROD ? genGuidesStaticParams('integrations') : getEmptyArray
 const generateMetadata = genGuideMeta((params: { slug?: string[] }) =>
   getGuidesMarkdown(['integrations', ...(params.slug ?? [])])
 )

apps/docs/app/guides/local-development/[[...slug]]/page.tsx

@@ -4,8 +4,8 @@ import {
   genGuidesStaticParams,
 } from '~/features/docs/GuidesMdx.utils'
 import { GuideTemplate } from '~/features/docs/GuidesMdx.template'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
+import { getEmptyArray } from '~/features/helpers.fn'
 
 type Params = { slug?: string[] }
 
@@ -17,7 +17,7 @@ const LocalDevelopmentGuidePage = async (props: { params: Promise<Params> }) =>
   return <GuideTemplate {...data!} />
 }
 
-const generateStaticParams = genGuidesStaticParams('local-development')
+const generateStaticParams = IS_PROD ? genGuidesStaticParams('local-development') : getEmptyArray
 const generateMetadata = genGuideMeta((params: { slug?: string[] }) =>
   getGuidesMarkdown(['local-development', ...(params.slug ?? [])])
 )

apps/docs/app/guides/platform/[[...slug]]/page.tsx

@@ -4,8 +4,8 @@ import {
   genGuidesStaticParams,
 } from '~/features/docs/GuidesMdx.utils'
 import { GuideTemplate } from '~/features/docs/GuidesMdx.template'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
+import { getEmptyArray } from '~/features/helpers.fn'
 
 type Params = { slug?: string[] }
 
@@ -17,7 +17,7 @@ const PlatformGuidePage = async (props: { params: Promise<Params> }) => {
   return <GuideTemplate {...data!} />
 }
 
-const generateStaticParams = genGuidesStaticParams('platform')
+const generateStaticParams = IS_PROD ? genGuidesStaticParams('platform') : getEmptyArray
 const generateMetadata = genGuideMeta((params: { slug?: string[] }) =>
   getGuidesMarkdown(['platform', ...(params.slug ?? [])])
 )

apps/docs/app/guides/queues/[[...slug]]/page.tsx

@@ -4,8 +4,8 @@ import {
   genGuidesStaticParams,
 } from '~/features/docs/GuidesMdx.utils'
 import { GuideTemplate } from '~/features/docs/GuidesMdx.template'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
+import { getEmptyArray } from '~/features/helpers.fn'
 
 type Params = { slug?: string[] }
 
@@ -17,7 +17,7 @@ const QueuesGuidePage = async (props: { params: Promise<Params> }) => {
   return <GuideTemplate {...data!} />
 }
 
-const generateStaticParams = genGuidesStaticParams('queues')
+const generateStaticParams = IS_PROD ? genGuidesStaticParams('queues') : getEmptyArray
 const generateMetadata = genGuideMeta((params: { slug?: string[] }) =>
   getGuidesMarkdown(['queues', ...(params.slug ?? [])])
 )

apps/docs/app/guides/realtime/troubleshooting/page.tsx

@@ -0,0 +1,15 @@
+import SectionTroubleshootingPage, {
+  generateSectionTroubleshootingMetadata,
+} from '~/features/docs/TroubleshootingSection.page'
+
+export default async function RealtimeTroubleshootingPage() {
+  return (
+    <SectionTroubleshootingPage
+      topic="realtime"
+      sectionName="Realtime"
+      description="Search or browse troubleshooting guides for common realtime issues, including connection problems, subscription management, and message delivery."
+    />
+  )
+}
+
+export const metadata = generateSectionTroubleshootingMetadata('realtime', 'Realtime')

apps/docs/app/guides/resources/[[...slug]]/page.tsx

@@ -4,8 +4,8 @@ import {
   genGuidesStaticParams,
 } from '~/features/docs/GuidesMdx.utils'
 import { GuideTemplate } from '~/features/docs/GuidesMdx.template'
-
-export const dynamicParams = false
+import { IS_PROD } from 'common'
+import { getEmptyArray } from '~/features/helpers.fn'
 
 type Params = { slug?: string[] }
 
@@ -17,7 +17,7 @@ const ResourcesGuidePage = async (props: { params: Promise<Params> }) => {
   return <GuideTemplate {...data!} />
 }
 
-const generateStaticParams = genGuidesStaticParams('resources')
+const generateStaticParams = IS_PROD ? genGuidesStaticParams('resources') : getEmptyArray
 const generateMetadata = genGuideMeta((params: { slug?: string[] }) =>
   getGuidesMarkdown(['resources', ...(params.slug ?? [])])
 )