The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.
TypeScript aialternativeauthdatabasedenoembeddingsexamplefirebasenextjsoauth2pgvectorpostgispostgrespostgresqlpostgrestrealtimesupabasevectorswebsockets
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.ymldeleted file mode 100644index 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-manifestdiff --git a/apps/docs/internals/generate-guides-markdown.ts b/apps/docs/internals/generate-guides-markdown.tsindex 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 | MdxJsxTextElementtype 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 = 0await 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.tsdeleted file mode 100644index 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.tsdeleted file mode 100644index 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.tsindex 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.jsonindex 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.jsoncindex 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",