Skip to content

The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.

fix: Refine and simplify markdown pipeline (#47416)

Jeremias Menichelli2d8d2aa7db0d
diff --git a/.github/workflows/docs-markdown-manifest-sync.yml b/.github/workflows/docs-markdown-manifest-sync.yml
deleted file mode 100644
index 815d3edc57b..00000000000
--- a/.github/workflows/docs-markdown-manifest-sync.yml
+++ /dev/null
@@ -1,55 +0,0 @@
-name: Docs Markdown Manifest Sync
-
-on:
- pull_request:
- branches: ['master']
- paths:
- - 'apps/docs/content/guides/**/*.mdx'
- - 'apps/docs/content/troubleshooting/**/*.mdx'
- - 'apps/docs/internals/generate-markdown-manifest.ts'
- - 'apps/docs/internals/markdown-sources.ts'
- - 'apps/docs/lib/markdown-manifest.ts'
-
-# Cancel old builds on new commit for same workflow + branch/PR
-concurrency:
- group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
- cancel-in-progress: true
-
-permissions:
- contents: read
-
-env:
- CI: true
-
-jobs:
- check:
- name: Check apps/docs/lib/markdown-manifest.ts is in sync
- runs-on: blacksmith-4vcpu-ubuntu-2404
-
- steps:
- - uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4.3.0
- with:
- persist-credentials: false
- sparse-checkout: |
- apps/docs
- examples
- packages
- supabase
- patches
-
- - uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4.2.0
- name: Install pnpm
- with:
- run_install: false
-
- - name: Use Node.js
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
- with:
- node-version-file: '.nvmrc'
- cache: 'pnpm'
-
- - name: Install deps
- run: pnpm install --frozen-lockfile
-
- - name: Verify markdown manifest is up to date
- run: pnpm --filter docs check:markdown-manifest
diff --git a/apps/docs/internals/generate-guides-markdown.ts b/apps/docs/internals/generate-guides-markdown.ts
index 462c0c3d969..2d639b35d10 100644
--- a/apps/docs/internals/generate-guides-markdown.ts
+++ b/apps/docs/internals/generate-guides-markdown.ts
@@ -27,9 +27,18 @@ import { RegionsList, SmartRegionsList } from './markdown-schema/RegionsList'
import { SharedData } from './markdown-schema/SharedData'
import { StepHike } from './markdown-schema/StepHike'
import { TabPanel } from './markdown-schema/TabPanel'
-import { collectMarkdownSources, type FrontmatterFormat } from './markdown-sources'
+import {
+ collectMarkdownSources,
+ type FrontmatterFormat,
+ type MarkdownSource,
+} from './markdown-sources'
const PARTIALS_DIR = path.join(process.cwd(), 'content', '_partials')
+// The set of guide slugs that have a generated markdown (.md) variant. middleware.ts
+// imports this to decide whether a bot request for /guides/<slug> can be served
+// markdown. It lives under the gitignored public/markdown/ output dir and is
+// regenerated by build:guides-markdown, which turbo runs ahead of build/typecheck/lint.
+const MANIFEST_PATH = path.join(process.cwd(), 'public', 'markdown', 'manifest.json')
type JsxNode = MdxJsxFlowElement | MdxJsxTextElement
type Props = Record<string, unknown>
@@ -191,9 +200,13 @@ async function generateOne(sourceFile: string, frontmatter: FrontmatterFormat):
return transformBody(content, data)
}
+function renderManifest(sources: MarkdownSource[]): string {
+ const slugs = [...new Set(sources.map((source) => source.slug))].sort()
+ return `${JSON.stringify(slugs, null, 2)}\n`
+}
+
async function generate() {
const sources = await collectMarkdownSources()
- let warnings = 0
await Promise.all(
sources.map(async ({ sourceFile, outPath, frontmatter }) => {
@@ -201,15 +214,10 @@ async function generate() {
try {
output = await generateOne(sourceFile, frontmatter)
} catch (err) {
- warnings++
- console.warn(
- `[warn] Failed to process ${sourceFile}: ${err instanceof Error ? err.message : err}`
+ throw new Error(
+ `Failed to process ${sourceFile}: ${err instanceof Error ? err.message : err}`,
+ { cause: err }
)
- try {
- output = await fs.readFile(sourceFile, 'utf8')
- } catch {
- output = `<!-- failed to generate: ${sourceFile} -->`
- }
}
await fs.mkdir(path.dirname(outPath), { recursive: true })
@@ -217,8 +225,15 @@ async function generate() {
})
)
- const summary = warnings ? ` (${warnings} with warnings)` : ''
- console.log(`Generated ${sources.length} markdown files under public/markdown/guides/${summary}`)
+ await fs.mkdir(path.dirname(MANIFEST_PATH), { recursive: true })
+ await fs.writeFile(MANIFEST_PATH, renderManifest(sources))
+
+ console.log(
+ `Generated ${sources.length} markdown files under public/markdown/guides/ and updated public/markdown/manifest.json`
+ )
}
-generate()
+generate().catch((error) => {
+ console.error(error)
+ process.exit(1)
+})
diff --git a/apps/docs/internals/generate-markdown-manifest.ts b/apps/docs/internals/generate-markdown-manifest.ts
deleted file mode 100644
index 40362d8245b..00000000000
--- a/apps/docs/internals/generate-markdown-manifest.ts
+++ /dev/null
@@ -1,59 +0,0 @@
-import fs from 'node:fs/promises'
-import path from 'node:path'
-
-import { collectMarkdownSources } from './markdown-sources'
-
-const MANIFEST_PATH = path.join(process.cwd(), 'lib', 'markdown-manifest.ts')
-const RELATIVE_PATH = 'apps/docs/lib/markdown-manifest.ts'
-
-const HEADER = `// GENERATED FILE — DO NOT EDIT.
-//
-// The guide slugs that have a generated markdown (.md) variant. middleware.ts
-// imports this to decide whether a bot request for /guides/<slug> can be served
-// markdown. It is committed (not left under __generated__) so the import resolves
-// in every build context — turbo does not run the npm \`prebuild\` hook that
-// regenerates it, so a gitignored file would be missing during typecheck/lint.
-//
-// Regenerate with: pnpm --filter docs build:markdown-manifest
-// CI fails if this drifts from the content sources (docs-markdown-manifest-sync workflow).
-`
-
-async function collectSlugs(): Promise<string[]> {
- const sources = await collectMarkdownSources()
- return [...new Set(sources.map((source) => source.slug))].sort()
-}
-
-function renderManifest(slugs: string[]): string {
- return `${HEADER}\nexport const MARKDOWN_SLUGS: readonly string[] = ${JSON.stringify(slugs, null, 2)}\n`
-}
-
-async function main() {
- const slugs = await collectSlugs()
- const expected = renderManifest(slugs)
-
- if (process.argv.includes('--check')) {
- let actual: string | null = null
- try {
- actual = await fs.readFile(MANIFEST_PATH, 'utf8')
- } catch {
- actual = null
- }
-
- if (actual !== expected) {
- console.error(
- `${RELATIVE_PATH} is out of sync with the markdown content sources.\n` +
- 'Run `pnpm --filter docs build:markdown-manifest` and commit the result.'
- )
- process.exit(1)
- }
-
- console.log(`${RELATIVE_PATH} is up to date (${slugs.length} slugs).`)
- return
- }
-
- await fs.mkdir(path.dirname(MANIFEST_PATH), { recursive: true })
- await fs.writeFile(MANIFEST_PATH, expected)
- console.log(`Wrote ${slugs.length} slugs to ${RELATIVE_PATH}`)
-}
-
-main()
diff --git a/apps/docs/lib/markdown-manifest.ts b/apps/docs/lib/markdown-manifest.ts
deleted file mode 100644
index 2a268c9ca9a..00000000000
--- a/apps/docs/lib/markdown-manifest.ts
+++ /dev/null
@@ -1,758 +0,0 @@
-// GENERATED FILE — DO NOT EDIT.
-//
-// The guide slugs that have a generated markdown (.md) variant. middleware.ts
-// imports this to decide whether a bot request for /guides/<slug> can be served
-// markdown. It is committed (not left under __generated__) so the import resolves
-// in every build context — turbo does not run the npm `prebuild` hook that
-// regenerates it, so a gitignored file would be missing during typecheck/lint.
-//
-// Regenerate with: pnpm --filter docs build:markdown-manifest
-// CI fails if this drifts from the content sources (docs-markdown-manifest-sync workflow).
-
-export const MARKDOWN_SLUGS: readonly string[] = [
- "ai",
- "ai-tools",
- "ai-tools/ai-prompts",
- "ai-tools/ai-skills",
- "ai-tools/byo-mcp",
- "ai-tools/mcp",
- "ai-tools/plugins",
- "ai/automatic-embeddings",
- "ai/choosing-compute-addon",
- "ai/concepts",
- "ai/engineering-for-scale",
- "ai/examples/building-chatgpt-plugins",
- "ai/examples/headless-vector-search",
- "ai/examples/huggingface-image-captioning",
- "ai/examples/image-search-openai-clip",
- "ai/examples/mixpeek-video-search",
- "ai/examples/nextjs-vector-search",
- "ai/examples/openai",
- "ai/examples/semantic-image-search-amazon-titan",
- "ai/going-to-prod",
- "ai/google-colab",
- "ai/hugging-face",
- "ai/hybrid-search",
- "ai/integrations/amazon-bedrock",
- "ai/integrations/llamaindex",
- "ai/integrations/roboflow",
- "ai/keyword-search",
- "ai/langchain",
- "ai/python-clients",
- "ai/quickstarts/face-similarity",
- "ai/quickstarts/generate-text-embeddings",
- "ai/quickstarts/hello-world",
- "ai/quickstarts/text-deduplication",
- "ai/rag-with-permissions",
- "ai/semantic-search",
- "ai/structured-unstructured",
- "ai/vecs-python-client",
- "ai/vector-columns",
- "ai/vector-indexes",
- "ai/vector-indexes/hnsw-indexes",
- "ai/vector-indexes/ivf-indexes",
- "api",
- "api/automatic-retries-in-supabase-js",
- "api/creating-routes",
- "api/custom-claims-and-role-based-access-control-rbac",
- "api/handling-errors-in-supabase-js",
- "api/quickstart",
- "api/rest/auto-generated-docs",
- "api/rest/client-libs",
- "api/rest/generating-python-types",
- "api/rest/generating-types",
- "api/rest/postgrest-error-codes",
- "api/securing-your-api",
- "api/sql-to-api",
- "api/sql-to-rest",
- "api/using-custom-schemas",
- "auth",
- "auth/architecture",
- "auth/audit-logs",
- "auth/auth-anonymous",
- "auth/auth-captcha",
- "auth/auth-email-passwordless",
- "auth/auth-email-templates",
- "auth/auth-hooks",
- "auth/auth-hooks/before-user-created-hook",
- "auth/auth-hooks/custom-access-token-hook",
- "auth/auth-hooks/mfa-verification-hook",
- "auth/auth-hooks/password-verification-hook",
- "auth/auth-hooks/send-email-hook",
- "auth/auth-hooks/send-sms-hook",
- "auth/auth-identity-linking",
- "auth/auth-mfa",
- "auth/auth-mfa/phone",
- "auth/auth-mfa/totp",
- "auth/auth-smtp",
- "auth/auth-web3",
- "auth/custom-oauth-providers",
- "auth/debugging/error-codes",
- "auth/enterprise-sso",
- "auth/enterprise-sso/auth-sso-saml",
- "auth/general-configuration",
- "auth/identities",
- "auth/jwt-fields",
- "auth/jwts",
- "auth/managing-user-data",
- "auth/native-mobile-deep-linking",
- "auth/oauth-server",
- "auth/oauth-server/getting-started",
- "auth/oauth-server/mcp-authentication",
- "auth/oauth-server/oauth-flows",
- "auth/oauth-server/token-security",
- "auth/passkeys",
- "auth/password-security",
- "auth/passwords",
- "auth/phone-login",
- "auth/quickstarts/astrojs",
- "auth/quickstarts/nextjs",
- "auth/quickstarts/react",
- "auth/quickstarts/react-native",
- "auth/quickstarts/with-expo-react-native-social-auth",
- "auth/rate-limits",
- "auth/redirect-urls",
- "auth/server-side",
- "auth/server-side/advanced-guide",
- "auth/server-side/creating-a-client",
- "auth/server-side/migrating-to-ssr-from-auth-helpers",
- "auth/sessions",
- "auth/sessions/implicit-flow",
- "auth/sessions/pkce-flow",
- "auth/signing-keys",
- "auth/signout",
- "auth/social-login",
- "auth/social-login/auth-apple",
- "auth/social-login/auth-azure",
- "auth/social-login/auth-bitbucket",
- "auth/social-login/auth-discord",
- "auth/social-login/auth-facebook",
- "auth/social-login/auth-figma",
- "auth/social-login/auth-github",
- "auth/social-login/auth-gitlab",
- "auth/social-login/auth-google",
- "auth/social-login/auth-kakao",
- "auth/social-login/auth-keycloak",
- "auth/social-login/auth-linkedin",
- "auth/social-login/auth-notion",
- "auth/social-login/auth-slack",
- "auth/social-login/auth-spotify",
- "auth/social-login/auth-twitch",
- "auth/social-login/auth-twitter",
- "auth/social-login/auth-workos",
- "auth/social-login/auth-zoom",
- "auth/third-party/auth0",
- "auth/third-party/aws-cognito",
- "auth/third-party/clerk",
- "auth/third-party/firebase-auth",
- "auth/third-party/overview",
- "auth/third-party/workos",
- "auth/users",
- "cli",
- "cron",
- "cron/install",
- "cron/quickstart",
- "database/arrays",
- "database/beekeeper-studio",
- "database/connecting-to-postgres",
- "database/connecting-to-postgres/serverless-drivers",
- "database/connection-management",
- "database/custom-postgres-config",
- "database/dbeaver",
- "database/debugging-performance",
- "database/drizzle",
- "database/extensions",
- "database/extensions/http",
- "database/extensions/hypopg",
- "database/extensions/index_advisor",
- "database/extensions/pg_cron",
- "database/extensions/pg_graphql",
- "database/extensions/pg_hashids",
- "database/extensions/pg_jsonschema",
- "database/extensions/pg_net",
- "database/extensions/pg_partman",
- "database/extensions/pg_plan_filter",
- "database/extensions/pg_repack",
- "database/extensions/pg_stat_statements",
- "database/extensions/pgaudit",
- "database/extensions/pgjwt",
- "database/extensions/pgmq",
- "database/extensions/pgroonga",
- "database/extensions/pgrouting",
- "database/extensions/pgsodium",
- "database/extensions/pgtap",
- "database/extensions/pgvector",
- "database/extensions/plpgsql_check",
- "database/extensions/plv8",
- "database/extensions/postgis",
- "database/extensions/postgres_fdw",
- "database/extensions/rum",
- "database/extensions/timescaledb",
- "database/extensions/uuid-ossp",
- "database/extensions/wrappers/overview",
- "database/full-text-search",
- "database/functions",
- "database/import-data",
- "database/inspect",
- "database/joins-and-nesting",
- "database/json",
- "database/metabase",
- "database/migrating-to-pg-partman",
- "database/orioledb",
- "database/overview",
- "database/partitions",
- "database/pgadmin",
- "database/postgres-js",
- "database/postgres/cascade-deletes",
- "database/postgres/column-level-security",
- "database/postgres/configuration",
- "database/postgres/data-deletion",
- "database/postgres/dropping-all-tables-in-schema",
- "database/postgres/enums",
- "database/postgres/event-triggers",
- "database/postgres/first-row-in-group",
- "database/postgres/indexes",
- "database/postgres/roles",
- "database/postgres/roles-superuser",
- "database/postgres/row-level-security",
- "database/postgres/setup-replication-external",
- "database/postgres/timeouts",
- "database/postgres/triggers",
- "database/postgres/which-version-of-postgres",
- "database/prisma",
- "database/prisma/prisma-troubleshooting",
- "database/psql",
- "database/query-optimization",
- "database/replication",
- "database/replication/bigquery",
- "database/replication/manual-replication-faq",
- "database/replication/manual-replication-monitoring",
- "database/replication/manual-replication-setup",
- "database/replication/pipelines",
- "database/replication/pipelines-faq",
- "database/replication/pipelines-monitoring",
- "database/secure-data",
- "database/supavisor",
- "database/tables",
- "database/testing",
- "database/vault",
- "database/webhooks",
- "deployment",
- "deployment/branching",
- "deployment/branching/configuration",
- "deployment/branching/dashboard",
- "deployment/branching/github-integration",
- "deployment/branching/integrations",
- "deployment/branching/troubleshooting",
- "deployment/branching/working-with-branches",
- "deployment/database-migrations",
- "deployment/going-into-prod",
- "deployment/managing-environments",
- "deployment/maturity-model",
- "deployment/shared-responsibility-model",
- "functions",
- "functions/ai-models",
- "functions/architecture",
- "functions/auth",
- "functions/auth-headers",
- "functions/auth-legacy-jwt",
- "functions/background-tasks",
- "functions/compression",
- "functions/connect-to-postgres",
- "functions/cors",
- "functions/dart-edge",
- "functions/debugging-tools",
- "functions/dependencies",
- "functions/deploy",
- "functions/development-environment",
- "functions/development-tips",
- "functions/ephemeral-storage",
- "functions/error-codes",
- "functions/error-handling",
- "functions/examples/amazon-bedrock-image-generator",
- "functions/examples/auth-send-email-hook-react-email-resend",
- "functions/examples/cloudflare-turnstile",
- "functions/examples/discord-bot",
- "functions/examples/elevenlabs-generate-speech-stream",
- "functions/examples/elevenlabs-transcribe-speech",
- "functions/examples/github-actions",
- "functions/examples/image-manipulation",
- "functions/examples/mcp-server-mcp-lite",
- "functions/examples/og-image",
- "functions/examples/push-notifications",
- "functions/examples/rate-limiting",
- "functions/examples/resumable-websockets",
- "functions/examples/screenshots",
- "functions/examples/semantic-search",
- "functions/examples/send-emails",
- "functions/examples/sentry-monitoring",
- "functions/examples/slack-bot-mention",
- "functions/examples/stripe-webhooks",
- "functions/examples/telegram-bot",
- "functions/examples/upstash-redis",
- "functions/function-configuration",
- "functions/http-methods",
- "functions/kysely-postgres",
- "functions/limits",
- "functions/logging",
- "functions/pricing",
- "functions/quickstart",
- "functions/quickstart-dashboard",
- "functions/recursive-functions",
- "functions/regional-invocation",
- "functions/routing",
- "functions/schedule-functions",
- "functions/secrets",
- "functions/status-codes",
- "functions/storage-caching",
- "functions/unit-test",
- "functions/wasm",
- "functions/websockets",
- "getting-started",
- "getting-started/api-keys",
- "getting-started/architecture",
- "getting-started/features",
- "getting-started/migrating-to-new-api-keys",
- "getting-started/quickstarts/astrojs",
- "getting-started/quickstarts/expo-react-native",
- "getting-started/quickstarts/flask",
- "getting-started/quickstarts/flutter",
- "getting-started/quickstarts/hono",
- "getting-started/quickstarts/ios-swiftui",
- "getting-started/quickstarts/kotlin",
- "getting-started/quickstarts/laravel",
- "getting-started/quickstarts/nextjs",
- "getting-started/quickstarts/nuxtjs",
- "getting-started/quickstarts/reactjs",
- "getting-started/quickstarts/redwoodjs",
- "getting-started/quickstarts/refine",
- "getting-started/quickstarts/ruby-on-rails",
- "getting-started/quickstarts/solidjs",
- "getting-started/quickstarts/sveltekit",
- "getting-started/quickstarts/tanstack",
- "getting-started/quickstarts/vue",
- "getting-started/tutorials/with-angular",
- "getting-started/tutorials/with-expo-react-native",
- "getting-started/tutorials/with-flutter",
- "getting-started/tutorials/with-ionic-angular",
- "getting-started/tutorials/with-ionic-react",
- "getting-started/tutorials/with-ionic-vue",
- "getting-started/tutorials/with-kotlin",
- "getting-started/tutorials/with-nextjs",
- "getting-started/tutorials/with-nuxt-3",
- "getting-started/tutorials/with-react",
- "getting-started/tutorials/with-redwoodjs",
- "getting-started/tutorials/with-refine",
- "getting-started/tutorials/with-solidjs",
- "getting-started/tutorials/with-svelte",
- "getting-started/tutorials/with-sveltekit",
- "getting-started/tutorials/with-swift",
- "getting-started/tutorials/with-vue-3",
- "integrations",
- "integrations/build-a-supabase-oauth-integration",
- "integrations/build-a-supabase-oauth-integration/oauth-scopes",
- "integrations/partner-integration-guide",
- "integrations/supabase-for-platforms",
- "integrations/supabase-marketplace",
- "integrations/vercel-marketplace",
- "local-development",
- "local-development/cli/getting-started",
- "local-development/cli/testing-and-linting",
- "local-development/customizing-email-templates",
- "local-development/declarative-database-schemas",
- "local-development/managing-config",
- "local-development/overview",
- "local-development/restoring-downloaded-backup",
- "local-development/seeding-your-database",
- "local-development/testing/overview",
- "local-development/testing/pgtap-extended",
- "platform",
- "platform/access-control",
- "platform/aws-marketplace",
- "platform/aws-marketplace/account-setup",
- "platform/aws-marketplace/faq",
- "platform/aws-marketplace/getting-started",
- "platform/aws-marketplace/invoices",
- "platform/aws-marketplace/manage-your-subscription",
- "platform/backups",
- "platform/billing-faq",
- "platform/billing-on-supabase",
- "platform/clone-project",
- "platform/compute-and-disk",
- "platform/cost-control",
- "platform/credits",
- "platform/custom-domains",
- "platform/database-size",
- "platform/free-project-pausing",
- "platform/get-set-up-for-billing",
- "platform/hipaa-projects",
- "platform/ipv4-address",
- "platform/manage-your-subscription",
- "platform/manage-your-usage",
- "platform/manage-your-usage/advanced-mfa-phone",
- "platform/manage-your-usage/branching",
- "platform/manage-your-usage/compute",
- "platform/manage-your-usage/custom-domains",
- "platform/manage-your-usage/disk-iops",
- "platform/manage-your-usage/disk-size",
- "platform/manage-your-usage/disk-throughput",
- "platform/manage-your-usage/edge-function-invocations",
- "platform/manage-your-usage/egress",
- "platform/manage-your-usage/ipv4",
- "platform/manage-your-usage/log-drains",
- "platform/manage-your-usage/logs",
- "platform/manage-your-usage/logs-ingest",
- "platform/manage-your-usage/logs-query",
- "platform/manage-your-usage/monthly-active-users",
- "platform/manage-your-usage/monthly-active-users-sso",
- "platform/manage-your-usage/monthly-active-users-third-party",
- "platform/manage-your-usage/point-in-time-recovery",
- "platform/manage-your-usage/read-replicas",
- "platform/manage-your-usage/realtime-messages",
- "platform/manage-your-usage/realtime-peak-connections",
- "platform/manage-your-usage/storage-image-transformations",
- "platform/manage-your-usage/storage-size",
- "platform/mfa/org-mfa-enforcement",
- "platform/migrating-to-supabase",
- "platform/migrating-to-supabase/amazon-rds",
- "platform/migrating-to-supabase/auth0",
- "platform/migrating-to-supabase/firebase-auth",
- "platform/migrating-to-supabase/firebase-storage",
- "platform/migrating-to-supabase/firestore-data",
- "platform/migrating-to-supabase/heroku",
- "platform/migrating-to-supabase/mssql",
- "platform/migrating-to-supabase/mysql",
- "platform/migrating-to-supabase/neon",
- "platform/migrating-to-supabase/postgres",
- "platform/migrating-to-supabase/render",
- "platform/migrating-to-supabase/vercel-postgres",
- "platform/migrating-within-supabase",
- "platform/migrating-within-supabase/backup-restore",
- "platform/migrating-within-supabase/dashboard-restore",
- "platform/multi-factor-authentication",
- "platform/network-restrictions",
- "platform/performance",
- "platform/permissions",
- "platform/postgres-connection-logging",
- "platform/privatelink",
- "platform/project-transfer",
- "platform/read-replicas",
- "platform/read-replicas/getting-started",
- "platform/regions",
- "platform/ssl-enforcement",
- "platform/sso",
- "platform/sso/azure",
- "platform/sso/choosing-login-flow",
- "platform/sso/gsuite",
- "platform/sso/login-flows",
- "platform/sso/multiple-providers",
- "platform/sso/okta",
- "platform/sso/testing-best-practices",
- "platform/temporary-access",
- "platform/upgrading",
- "platform/your-monthly-invoice",
- "queues",
- "queues/api",
- "queues/consuming-messages-with-edge-functions",
- "queues/expose-self-hosted-queues",
- "queues/pgmq",
- "queues/quickstart",
- "realtime",
- "realtime/architecture",
- "realtime/authorization",
- "realtime/benchmarks",
- "realtime/broadcast",
- "realtime/concepts",
- "realtime/error_codes",
- "realtime/getting_started",
- "realtime/limits",
- "realtime/postgres-changes",
- "realtime/presence",
- "realtime/pricing",
- "realtime/protocol",
- "realtime/realtime-listening-flutter",
- "realtime/realtime-user-presence",
- "realtime/realtime-with-nextjs",
- "realtime/reports",
- "realtime/settings",
- "realtime/subscribing-to-database-changes",
- "resources",
- "resources/glossary",
- "security",
- "security/hipaa-compliance",
- "security/npm-security",
- "security/platform-audit-logs",
- "security/platform-security",
- "security/product-security",
- "security/security-testing",
- "security/soc-2-compliance",
- "self-hosting",
- "self-hosting/copy-from-platform-s3",
- "self-hosting/custom-email-templates",
- "self-hosting/docker",
- "self-hosting/enable-mcp",
- "self-hosting/postgres-upgrade-17",
- "self-hosting/remove-superuser-access",
- "self-hosting/restore-from-platform",
- "self-hosting/self-hosted-auth-keys",
- "self-hosting/self-hosted-envoy",
- "self-hosting/self-hosted-functions",
- "self-hosting/self-hosted-oauth",
- "self-hosting/self-hosted-phone-mfa",
- "self-hosting/self-hosted-proxy-https",
- "self-hosting/self-hosted-s3",
- "self-hosting/self-hosted-saml-sso",
- "storage",
- "storage/analytics/connecting-to-analytics-bucket",
- "storage/analytics/creating-analytics-buckets",
- "storage/analytics/examples/apache-spark",
- "storage/analytics/examples/duckdb",
- "storage/analytics/examples/pyiceberg",
- "storage/analytics/introduction",
- "storage/analytics/limits",
- "storage/analytics/pricing",
- "storage/analytics/query-with-postgres",
- "storage/buckets/creating-buckets",
- "storage/buckets/fundamentals",
- "storage/cdn/fundamentals",
- "storage/cdn/metrics",
- "storage/cdn/purge-cdn-cache",
- "storage/cdn/smart-cdn",
- "storage/debugging/error-codes",
- "storage/debugging/logs",
- "storage/management/copy-move-objects",
- "storage/management/delete-objects",
- "storage/management/download-objects",
- "storage/pricing",
- "storage/production/scaling",
- "storage/quickstart",
- "storage/s3/authentication",
- "storage/s3/compatibility",
- "storage/schema/custom-roles",
- "storage/schema/design",
- "storage/schema/helper-functions",
- "storage/security/access-control",
- "storage/security/ownership",
- "storage/serving/bandwidth",
- "storage/serving/downloads",
- "storage/serving/image-transformations",
- "storage/uploads/file-limits",
- "storage/uploads/resumable-uploads",
- "storage/uploads/s3-uploads",
- "storage/uploads/standard-uploads",
- "storage/vector/creating-vector-buckets",
- "storage/vector/introduction",
- "storage/vector/limits",
- "storage/vector/local-development",
- "storage/vector/querying-vectors",
- "storage/vector/storing-vectors",
- "storage/vector/working-with-indexes",
- "telemetry",
- "telemetry/advanced-log-filtering",
- "telemetry/client-side-tracing",
- "telemetry/log-drains",
- "telemetry/log-field-reference",
- "telemetry/logs",
- "telemetry/metrics",
- "telemetry/metrics/grafana-cloud",
- "telemetry/metrics/grafana-self-hosted",
- "telemetry/metrics/vendor-agnostic",
- "telemetry/reports",
- "telemetry/sentry-monitoring",
- "troubleshooting/42501--permission-denied-for-table-httprequestqueue-KnozmQ",
- "troubleshooting/FWD-wrappers-error-component-verification-failed-94a76b",
- "troubleshooting/all-about-supabase-egress-a_Sg_e",
- "troubleshooting/an-invalid-response-was-received-from-the-upstream-server-error-when-querying-auth-RI4Vl-",
- "troubleshooting/app-store-rejection-tls-error-in-ipv6-only-environments-4e9c62",
- "troubleshooting/are-all-features-available-in-self-hosted-supabase-THPcqw",
- "troubleshooting/auth-error-401-invalid-claim-missing-sub--AFwMR",
- "troubleshooting/auth-error-503-authretryablefetcherror-51b88c",
- "troubleshooting/auth-hooks-invalid-payload-when-anonymous-users-attempt-phone-changes-022c47",
- "troubleshooting/autovacuum-stalled-due-to-inactive-replication-slot-d55aa2",
- "troubleshooting/avoiding-timeouts-in-long-running-queries-6nmbdN",
- "troubleshooting/canceling-statement-due-to-statement-timeout-581wFv",
- "troubleshooting/cant-access-supabase-project-lovable-cloud",
- "troubleshooting/certain-operations-are-too-complex-to-perform-directly-using-the-client-libraries-8JaphH",
- "troubleshooting/change-email-associated-with-supabase-account-T5eHNT",
- "troubleshooting/change-project-region-eWJo5Z",
- "troubleshooting/check-usage-for-monthly-active-users-mau-MwZaBs",
- "troubleshooting/cloudflare-origin-error-1016-on-custom-domain-a57af4",
- "troubleshooting/converted-github-account-to-organisation---lost-supabase-account-access-5wsE_1",
- "troubleshooting/customizing-emails-by-language-KZ_38Q",
- "troubleshooting/dashboard-errors-when-managing-users-N1ls4A",
- "troubleshooting/database-api-42501-errors",
- "troubleshooting/database-error-remaining-connection-slots-are-reserved-for-non-replication-superuser-connections-3V3nIb",
- "troubleshooting/database-error-saving-new-user-RU_EwB",
- "troubleshooting/deprecated-rls-features-Pm77Zs",
- "troubleshooting/disabling-prepared-statements-qL8lEL",
- "troubleshooting/discovering-and-interpreting-api-errors-in-the-logs-7xREI9",
- "troubleshooting/disk-size-not-shrinking-after-deleting-data-135390",
- "troubleshooting/do-i-need-to-expose-security-definer-functions-in-row-level-security-policies-iI0uOw",
- "troubleshooting/download-logical-backups",
- "troubleshooting/edge-function-401-error-response",
- "troubleshooting/edge-function-404-error-response",
- "troubleshooting/edge-function-500-error-response",
- "troubleshooting/edge-function-503-response",
- "troubleshooting/edge-function-504-error-response",
- "troubleshooting/edge-function-546-error-response",
- "troubleshooting/edge-function-bundle-size-issues",
- "troubleshooting/edge-function-cpu-limits",
- "troubleshooting/edge-function-dependency-analysis",
- "troubleshooting/edge-function-error-rate-limit-exceeded-for-trace-1094d3",
- "troubleshooting/edge-function-fails-deploy",
- "troubleshooting/edge-function-monitoring-resource-usage",
- "troubleshooting/edge-function-shutdown-reasons-explained",
- "troubleshooting/edge-function-takes-too-long-to-respond",
- "troubleshooting/edge-function-wall-clock-time-limit-reached-Nk38bW",
- "troubleshooting/edge-functions-worker-timeouts-and-websocket-drops",
- "troubleshooting/email-password-login-disabled-supabase-vercel-marketplace-a7dd36",
- "troubleshooting/email-template-not-updating",
- "troubleshooting/enabling-ipv4-addon",
- "troubleshooting/error-connection-refused-when-trying-to-connect-to-supabase-database-hwG0Dr",
- "troubleshooting/error-index-row-size-exceeds-btree-version-4-maximum-for-index-LMmoeU",
- "troubleshooting/error-invalid-byte-sequence-for-encoding-utf8-0x00-when-accessing-triggers-or-webhooks-e78cf8",
- "troubleshooting/error-invalid-totp-code-entered-CukLCj",
- "troubleshooting/error-no-pghbaconf-entry-for-host-xxxxxxxxxxx-user-postgres-database-postgres-ssl-off-GOt5Ja",
- "troubleshooting/error-prepared-statement-xxx-already-exists-3laqeM",
- "troubleshooting/error-target-organization-is-not-managed-by-vercel-marketplace-during-project-transfer-5262c3",
- "troubleshooting/exhaust-disk-io",
- "troubleshooting/exhaust-ram",
- "troubleshooting/exhaust-swap",
- "troubleshooting/failed-to-fetch-in-dashboard-and-other-areas----browser-extension-dyDTRU",
- "troubleshooting/failed-to-restore-from-backup-all-subscriptions-and-replication-slots-must-be-dropped-before-a-backup-can-be-restored-L-rCvt",
- "troubleshooting/failed-to-retrieve-tables",
- "troubleshooting/failed-to-run-sql-query-connection-terminated-due-to-connection-timeout",
- "troubleshooting/fetch-requests-to-api-endpoints-arent-showing-the-session-UbUwRs",
- "troubleshooting/fixing-520-errors-in-the-database-rest-api-Ur5-B2",
- "troubleshooting/forbidden-resource-error-from-the-cli-L6rm6l",
- "troubleshooting/get-detailed-storage-metrics-with-the-aws-cli-587a7d",
- "troubleshooting/google-auth-fails-for-some-users-XcFXEu",
- "troubleshooting/grafana-not-displaying-data-sXJrMj",
- "troubleshooting/high-cpu-and-slow-queries-with-error-must-be-a-superuser-to-terminate-superuser-process",
- "troubleshooting/high-cpu-usage",
- "troubleshooting/high-latency-with-supabase-client-z0pZzR",
- "troubleshooting/how-can-i-revoke-execution-of-a-postgresql-function-2GYb0A",
- "troubleshooting/how-do-i-check-gotrueapi-version-of-a-supabase-project-lQAnOR",
- "troubleshooting/how-do-i-make-the-cookies-httponly-vwweFx",
- "troubleshooting/how-do-i-reset-my-supabase-database-password-oTs5sB",
- "troubleshooting/how-do-i-update-connection-pool-settings-in-my-dashboard-wAxTJ_",
- "troubleshooting/how-do-you-troubleshoot-nextjs---supabase-auth-issues-riMCZV",
- "troubleshooting/how-long-does-it-take-to-restore-a-database-from-a-point-in-time-backup-pitr-qO8gOG",
- "troubleshooting/how-postgres-chooses-which-index-to-use-_JHrf4",
- "troubleshooting/how-to-bypass-cooldown-period",
- "troubleshooting/how-to-change-max-database-connections-_BQ8P5",
- "troubleshooting/how-to-check-if-my-queries-are-being-blocked-by-other-queries-NSKtR1",
- "troubleshooting/how-to-delete-a-role-in-postgres-8-AvxY",
- "troubleshooting/how-to-delete-vercel-linked-projects-9d08aa",
- "troubleshooting/how-to-interpret-and-explore-the-postgres-logs-OuCIOj",
- "troubleshooting/how-to-migrate-from-supabase-auth-helpers-to-ssr-package-5NRunM",
- "troubleshooting/how-to-view-database-metrics-uqf2z_",
- "troubleshooting/http-api-issues",
- "troubleshooting/http-status-codes",
- "troubleshooting/i-am-not-receiving-password-reset-emails-for-supabase-dashboard--cO5yf",
- "troubleshooting/identify-lovable-cloud-or-supabase-backend",
- "troubleshooting/importing-stripe-or-other-modules-from-esmsh-on-deno-edge-functions-throws-an-error-TmbB5p",
- "troubleshooting/increase-vector-lookup-speeds-by-applying-an-hsnw-index-ohLHUM",
- "troubleshooting/inserting-into-sequenceserial-table-causes-duplicate-key-violates-unique-constraint-error-pi6DnC",
- "troubleshooting/inspecting-edge-function-environment-variables-wg5qOQ",
- "troubleshooting/insufficient-privilege-when-accessing-pgstatstatements-e5M_EQ",
- "troubleshooting/interpreting-supabase-grafana-cpu-charts-9JSlkC",
- "troubleshooting/interpreting-supabase-grafana-io-charts-MUynDR",
- "troubleshooting/issues-serving-edge-functions-locally",
- "troubleshooting/jwt-expired-error-in-supabase-dashboard-F06k3x",
- "troubleshooting/keeping-free-projects-after-pro-upgrade-Kf9Xm2",
- "troubleshooting/kong-stops-responding-under-heavy-load-locally",
- "troubleshooting/lost-accessforgot-the-mfa-device-nAPT-7",
- "troubleshooting/managing-or-disconnecting-github-oauth-connections-e3dc3b",
- "troubleshooting/manually-created-databases-are-not-visible-in-the-supabase-dashboard-4415aa",
- "troubleshooting/memory-and-swap-usage-explained-aPNgm0",
- "troubleshooting/migrating-auth-users-between-projects",
- "troubleshooting/monitor-supavisor-postgres-connections",
- "troubleshooting/new-branch-doesnt-copy-database",
- "troubleshooting/new-variable-is-null-in-a-trigger-function--l9AOZ",
- "troubleshooting/nextjs-1314-stale-data-when-changing-rls-or-table-data-85b8oQ",
- "troubleshooting/no-toast-messages-on-the-dashboard-BrvP8h",
- "troubleshooting/not-receiving-auth-emails-from-the-supabase-project-OFSNzw",
- "troubleshooting/oauth-sign-in-isnt-redirecting-on-the-server-side-ShGMtr",
- "troubleshooting/otp-verification-failures-token-has-expired-or-otp_expired-errors-5ee4d0",
- "troubleshooting/partitioning-an-existing-table-with-same-name-VEnbzK",
- "troubleshooting/pausing-pro-projects-vNL-2a",
- "troubleshooting/performing-administration-tasks-on-the-server-side-with-the-servicerole-secret-BYM4Fa",
- "troubleshooting/pg_cron-launcher-crashes-with-duplicate-key-value-violates-unique-constraint-cc6472",
- "troubleshooting/pgcron-debugging-guide-n1KTaz",
- "troubleshooting/pgrst106-the-schema-must-be-one-of-the-following-error-when-querying-an-exposed-schema",
- "troubleshooting/pkce-flow-errors-cannot-parse-response-or-zgotmplz-in-magic-link-emails-433665",
- "troubleshooting/postgrest-error-400-column-example_tableexample_column-does-not-exist-when-using-or-operators-46ff23",
- "troubleshooting/postgrest-error-pgrst002-could-not-query-the-database-for-the-schema-cache-c396e9",
- "troubleshooting/postgrest-not-recognizing-new-columns-or-functions-bd75f5",
- "troubleshooting/postgrest-not-recognizing-objects-in-schema",
- "troubleshooting/powerbi-service-error-the-remote-certificate-is-invalid-according-to-the-validation-procedure-640a98",
- "troubleshooting/prisma-error-management-Cm5P_o",
- "troubleshooting/project-status-reports-unhealthy-services",
- "troubleshooting/rclone-error-s3-protocol-error-received-listing-v1-with-istruncated-set-no-nextmarker-and-no-contents-e64d34",
- "troubleshooting/realtime-concurrent-peak-connections-quota-jdDqcp",
- "troubleshooting/realtime-connections-timed_out-status",
- "troubleshooting/realtime-debugging-with-logger",
- "troubleshooting/realtime-handling-silent-disconnections-in-backgrounded-applications-592794",
- "troubleshooting/realtime-heartbeat-messages",
- "troubleshooting/realtime-project-suspended-for-exceeding-quotas",
- "troubleshooting/realtime-too-many-channels-error",
- "troubleshooting/realtime-warn-sending-broadcast-message",
- "troubleshooting/refresh-postgrest-schema",
- "troubleshooting/relation-objects-does-not-exist-error-during-storage-uploads-8f21f0",
- "troubleshooting/resolving-42p01-relation-does-not-exist-error-W4_9-V",
- "troubleshooting/resolving-500-status-authentication-errors-7bU5U8",
- "troubleshooting/resolving-cannot-execute-update-in-a-read-only-transaction-on-transaction-pooler-connections-ef582c",
- "troubleshooting/resolving-database-hostname-and-managing-your-ip-address-pVlwE0",
- "troubleshooting/restore-project-after-90-days-pause",
- "troubleshooting/rls-performance-and-best-practices-Z5Jjwv",
- "troubleshooting/rls-simplified-BJTcS8",
- "troubleshooting/rotating-anon-service-and-jwt-secrets-1Jq6yd",
- "troubleshooting/running-explain-analyze-on-functions",
- "troubleshooting/scan-error-on-column-confirmation_token-converting-null-to-string-is-unsupported-during-auth-login-a0c686",
- "troubleshooting/schema-pg_pgrst_no_exposed_schemas-does-not-exist",
- "troubleshooting/security-of-anonymous-sign-ins-iOrGCL",
- "troubleshooting/seeing-no-pghbaconf-entry-for-host-errors-in-postgres-and-they-come-from-an-ip-address-that-i-dont-recognize-4gds9f",
- "troubleshooting/should-i-set-a-shorter-max-age-parameter-on-the-cookies-8sbF4V",
- "troubleshooting/slow-execution-of-alter-table-on-large-table-when-changing-column-type-qmZRpZ",
- "troubleshooting/soft-deletes-with-supabase-js",
- "troubleshooting/sso-error-you-do-not-have-permissions-to-join-this-organization-or-prompts-to-create-new-organization",
- "troubleshooting/steps-to-improve-query-performance-with-indexes-q8PoC9",
- "troubleshooting/storage-error-403-forbidden-new-row-violates-row-level-security-policy-on-upload-a94384",
- "troubleshooting/supabase--your-network-ipv4-and-ipv6-compatibility-cHe3BP",
- "troubleshooting/supabase-cli-failed-sasl-auth-or-invalid-scram-server-final-message",
- "troubleshooting/supabase-dashboard-not-loading-project-not-loading-on-dashboard-LfMq9F",
- "troubleshooting/supabase-grafana-memory-charts",
- "troubleshooting/supabase-project-provisioned-via-bolt-not-visible-in-dashboard-7188fc",
- "troubleshooting/supabase-storage-inefficient-folder-operations-and-hierarchical-rls-challenges-b05a4d",
- "troubleshooting/supavisor-and-connection-terminology-explained-9pr_ZO",
- "troubleshooting/supavisor-error-circuit-breaker-open-after-password-rotation-0fdb72",
- "troubleshooting/supavisor-faq-YyP5tI",
- "troubleshooting/too-many-connections-for-database-postgres",
- "troubleshooting/tracking-postgres-role-activity-to-specific-dashboard-users-8d3715",
- "troubleshooting/transfer-edge-function-from-one-project-to-another",
- "troubleshooting/transferring-from-cloud-to-self-host-in-supabase-2oWNvW",
- "troubleshooting/troubleshooting-connect_timeout-or-hanging-queries-in-vercel-serverless-functions-775f92",
- "troubleshooting/unable-to-call-edge-function",
- "troubleshooting/unable-to-deploy-edge-function",
- "troubleshooting/understanding-postgresql-explain-output-Un9dqX",
- "troubleshooting/understanding-postgresql-logging-levels-and-how-they-impact-your-project-KXiJRm",
- "troubleshooting/understanding-the-usage-summary-on-the-dashboard-D7Gnle",
- "troubleshooting/unexpected-behavior-with-authupdateuser-phone-phone-linked-to-incorrect-user-id-45368f",
- "troubleshooting/unused-external-import-warning-vite-rollup",
- "troubleshooting/upload-file-size-restrictions-Y4wQLT",
- "troubleshooting/using-google-smtp-with-supabase-custom-smtp-ZZzU4Y",
- "troubleshooting/using-sqlalchemy-with-supabase-FUqebT",
- "troubleshooting/vercel-integration-environment-variables-not-syncing-for-persistent-git-branches-b9191e",
- "troubleshooting/webhook-debugging-guide-M8sk47",
- "troubleshooting/why-am-i-being-redirected-to-the-wrong-url-when-using-auth-redirectto-option-_vqIeO",
- "troubleshooting/why-are-there-gaps-in-my-postgres-id-sequence-Frifus",
- "troubleshooting/why-cant-i-uploadlistetc-my-public-bucket-Z6CmGt",
- "troubleshooting/why-do-i-see-auth--api-requests-in-the-dashboard-my-app-has-no-users-CyadiO",
- "troubleshooting/why-is-my-camelcase-name-not-working-in-postgres-functions-or-rls-policies-EJMzVd",
- "troubleshooting/why-is-my-select-returning-an-empty-data-array-and-i-have-data-in-the-table-xvOPgx",
- "troubleshooting/why-is-my-service-role-key-client-getting-rls-errors-or-not-returning-data-7_1K9z",
- "troubleshooting/why-is-my-supabase-api-call-not-returning-PGzXw0",
- "troubleshooting/why-supabase-edge-functions-cannot-provide-static-egress-ips-for-whitelisting-3d78b0",
- "troubleshooting/will-backups-be-accessible-from-the-dashboard-immediately-after-upgrading-to-a-paid-plan-hXY4rs"
-]
diff --git a/apps/docs/middleware.ts b/apps/docs/middleware.ts
index 8c534018604..4bbeeed8a65 100644
--- a/apps/docs/middleware.ts
+++ b/apps/docs/middleware.ts
@@ -1,6 +1,6 @@
import { clientSdkIds } from '~/content/navigation.references'
import { BASE_PATH } from '~/lib/constants'
-import { MARKDOWN_SLUGS } from '~/lib/markdown-manifest'
+import MARKDOWN_SLUGS from '~/public/markdown/manifest.json'
import { negotiateMarkdown } from 'common/markdown-negotiation'
import { isbot } from 'isbot'
import { NextResponse, type NextRequest } from 'next/server'
diff --git a/apps/docs/package.json b/apps/docs/package.json
index 089a1114267..dbc8d74b787 100644
--- a/apps/docs/package.json
+++ b/apps/docs/package.json
@@ -10,8 +10,6 @@
"prebuild:reference-markdown": "pnpm run codegen:references",
"build:reference-markdown": "tsx ./internals/generate-reference-markdown.ts",
"build:markdown": "pnpm build:guides-markdown && pnpm build:reference-markdown",
- "build:markdown-manifest": "tsx ./internals/generate-markdown-manifest.ts",
- "check:markdown-manifest": "tsx ./internals/generate-markdown-manifest.ts --check",
"build:gz-archive": "tsx ./internals/generate-gz-archive.ts",
"build:sitemap": "tsx ./internals/generate-sitemap.ts",
"clean": "rimraf .next .turbo node_modules features/docs/generated examples __generated__",
@@ -34,13 +32,16 @@
"lint": "eslint .",
"lint:mdx": "supa-mdx-lint content --config ../../supa-mdx-lint.config.toml",
"postbuild": "pnpm run build:sitemap && ./../../scripts/upload-static-assets.sh",
- "prebuild": "pnpm run codegen:graphql && pnpm run codegen:references && pnpm run codegen:examples && pnpm run build:markdown && pnpm run build:markdown-manifest && pnpm run build:gz-archive",
- "predev": "pnpm run codegen:graphql && pnpm run codegen:references && pnpm run codegen:examples && pnpm run build:markdown-manifest",
+ "prebuild": "pnpm run codegen:graphql && pnpm run codegen:references && pnpm run codegen:examples && pnpm run build:markdown && pnpm run build:gz-archive",
+ "predev": "pnpm run codegen:graphql && pnpm run codegen:references && pnpm run codegen:examples && pnpm run build:markdown",
"preembeddings": "pnpm run codegen:references",
"preinstall": "npx only-allow pnpm",
"presync": "pnpm run codegen:graphql",
"pretest": "pnpm run codegen:examples",
- "pretypecheck": "pnpm run codegen:graphql && pnpm run build:markdown-manifest && next typegen",
+ "pretest:local": "pnpm run build:guides-markdown",
+ "pretest:local:unwatch": "pnpm run build:guides-markdown",
+ "pretest:smoke": "pnpm run build:guides-markdown",
+ "pretypecheck": "pnpm run codegen:graphql && pnpm run build:markdown && next typegen",
"start": "next start",
"sync": "tsx --conditions=react-server ./resources/rootSync.ts",
"test": "pnpm supabase start && pnpm run test:local && pnpm supabase stop",
diff --git a/apps/docs/turbo.jsonc b/apps/docs/turbo.jsonc
index b025460e4ac..6ffd9e5257a 100644
--- a/apps/docs/turbo.jsonc
+++ b/apps/docs/turbo.jsonc
@@ -10,8 +10,14 @@
"inputs": ["spec/**"],
"outputs": ["features/docs/generated/**"],
},
+ // Generates the guide/reference .md files and manifest.json under public/markdown/.
+ // Declaring outputs lets Turbo restore these artifacts on a cache hit; without it a
+ // cached run would skip the script and leave the generated markdown missing for `next build`.
+ "build:markdown": {
+ "outputs": ["public/markdown/**", "public/markdown/manifest.json"],
+ },
"build": {
- "dependsOn": ["^build", "codegen:examples", "codegen:references"],
+ "dependsOn": ["^build", "codegen:examples", "codegen:references", "build:markdown"],
"env": [
"ANALYZE",
"NEXT_PUBLIC_SUPABASE_URL",