chore: move specs to docs folder (#20136)

.dockerignore

@@ -7,7 +7,7 @@ docker
 examples
 i18n
 **/node_modules
-spec
+apps/docs/spec
 supabase
 tests
 

.github/workflows/search.yml

@@ -8,7 +8,6 @@ on:
       - '.github/workflows/search.yml'
       - 'supabase/migrations/**'
       - 'apps/docs/**'
-      - 'spec/**'
   workflow_dispatch:
     inputs:
       refresh:
@@ -39,7 +38,6 @@ jobs:
         with:
           sparse-checkout: |
             apps/docs
-            spec
             supabase
 
       - name: Setup node

.prettierignore

@@ -4,6 +4,7 @@ node_modules
 package-lock.json
 docker*
 apps/**/out
+apps/docs/spec/**
 # prettier-plugin-sql-cst only supports sqlite syntax
 **/supabase/migrations/*.sql
 apps/www/schema.sql

DEVELOPERS.md

@@ -1,15 +1,25 @@
 # Developing Supabase
 
-1. [Getting started](#getting-started)
-   - [Install dependencies](#install-dependencies)
-2. [Local development](#local-development)
-   - [Fork the repo](#fork-the-repo)
-   - [Clone the repo](#clone-the-repo)
-   - [Running turborepo](#running-turborepo)
-     - [Shared components](#shared-components)
-     - [Installing packages](#installing-packages)
-   - [New Supabase docs](#new-supabase-docs)
-3. [Create a pull request](#create-a-pull-request)
+- [Developing Supabase](#developing-supabase)
+  - [Getting started](#getting-started)
+    - [Install dependencies](#install-dependencies)
+  - [Local development](#local-development)
+    - [Fork the repo](#fork-the-repo)
+    - [Clone the repo](#clone-the-repo)
+    - [Install dependencies](#install-dependencies-1)
+      - [Running sites individually](#running-sites-individually)
+      - [Shared components](#shared-components)
+      - [Installing packages](#installing-packages)
+  - [Running Docker for Supabase Studio](#running-docker-for-supabase-studio)
+      - [Prerequsites](#prerequsites)
+      - [Get Started](#get-started)
+  - [Create a pull request](#create-a-pull-request)
+  - [Issue assignment](#issue-assignment)
+  - [Common tasks](#common-tasks)
+    - [Add a redirect](#add-a-redirect)
+    - [Federated docs](#federated-docs)
+  - [Community channels](#community-channels)
+  - [Contributors](#contributors)
 
 - [Common tasks](#common-tasks)
   - [Add a redirect](#add-a-redirect)
@@ -86,10 +96,12 @@ npm run dev:www
 
 The monorepo has a set of shared components under `/packages`:
 
-- `/packages/common`: Common React components, shared between all sites.
+- `/packages/ai-commands`: Helpers/Commands for AI related functions
+- `/packages/common`: Common React components, shared between all sites
 - `/packages/config`: All shared config
-- `/packages/spec`: Generates documentation using spec files.
+- `/packages/shared-data`: Shared data that can be used across all apps
 - `/packages/tsconfig`: Shared Typescript settings
+- `/packages/ui`: Common UI components
 
 #### Installing packages
 

apps/docs/CONTRIBUTING.md

@@ -77,7 +77,7 @@ You can usually identify a federated or reference doc because it uses a Next.js
 Example spec file import:
 
 ```js
-import specFile from '~/../../spec/transforms/analytics_v0_openapi_deparsed.json' assert { type: 'json' }
+import specFile from '~/spec/transforms/analytics_v0_openapi_deparsed.json' assert { type: 'json' }
 ```
 
 Example repo definition:

apps/docs/components/Navigation/NavigationMenu/NavigationMenu.utils.ts

@@ -51,7 +51,7 @@ export function useCommonSections(commonSectionsFile: string) {
       const commonSections = await import(
         /* webpackInclude: /common-.*\.json$/ */
         /* webpackMode: "lazy" */
-        `~/../../spec/${commonSectionsFile}`
+        `~/spec/${commonSectionsFile}`
       )
       setCommonSections(commonSections.default)
     }
@@ -80,7 +80,7 @@ export function useSpec(specFile?: string) {
       const spec = await import(
         /* webpackInclude: /supabase_.*\.ya?ml$/ */
         /* webpackMode: "lazy" */
-        `~/../../spec/${specFile}`
+        `~/spec/${specFile}`
       )
       setSpec(spec.default)
     }

apps/docs/components/Navigation/NavigationMenu/NavigationMenuCliList.tsx

@@ -3,7 +3,7 @@ import { useRouter } from 'next/router'
 import { IconChevronLeft } from 'ui'
 import * as NavItems from './NavigationMenu.constants'
 
-import clientLibsCommon from '~/../../spec/common-cli.yml' assert { type: 'yml' }
+import clientLibsCommon from '~/spec/common-cli.yml' assert { type: 'yml' }
 
 const NavigationMenuCliList = ({ currentLevel, setLevel, id }) => {
   const router = useRouter()

apps/docs/components/reference/CLICommandSection.tsx

@@ -1,6 +1,6 @@
 import ReactMarkdown from 'react-markdown'
 import { CodeBlock, IconChevronRight, Tabs } from 'ui'
-import spec from '~/../../spec/cli_v1_commands.yaml' assert { type: 'yml' }
+import spec from '~/spec/cli_v1_commands.yaml' assert { type: 'yml' }
 import Options from '~/components/Options'
 import Param from '~/components/Params'
 import RefSubLayout from '~/layouts/ref/RefSubLayout'

apps/docs/components/reference/enrichments/cli/CliGlobalFlagsHandler.tsx

@@ -1,6 +1,6 @@
 import RefSubLayout from '~/layouts/ref/RefSubLayout'
 
-import spec from '~/../../spec/cli_v1_commands.yaml' assert { type: 'yaml' }
+import spec from '~/spec/cli_v1_commands.yaml' assert { type: 'yaml' }
 import Param from '~/components/Params'
 import Options from '~/components/Options'
 

apps/docs/docs/ref/python/installing.mdx

@@ -2,7 +2,7 @@
 id: installing
 title: 'Installing'
 slug: installing
-custom_edit_url: https://github.com/supabase/supabase/edit/master/spec/supabase_py_v2.yml
+custom_edit_url: https://github.com/supabase/supabase/edit/master/apps/docs/spec/supabase_py_v2.yml
 ---
 
 ### Install with PyPi

apps/docs/generator/legacy.ts

@@ -19,7 +19,7 @@ import * as yaml from 'js-yaml'
 import { flattenSections } from '../lib/helpers'
 
 const commonDocSpecJson = JSON.parse(
-  fs.readFileSync('../../spec/common-client-libs-sections.json', 'utf8')
+  fs.readFileSync('spec/common-client-libs-sections.json', 'utf8')
 )
 
 const flattenedCommonDocSpecJson = flattenSections(commonDocSpecJson)

apps/docs/internals/files/api.mjs

@@ -1,4 +1,4 @@
-import sections from '../../../../spec/common-api-sections.json' assert { type: 'json' }
+import sections from '../../spec/common-api-sections.json' assert { type: 'json' }
 import { flattenSections } from '../helpers.mjs'
 
 const flatSections = flattenSections(sections)

apps/docs/internals/files/cli.mjs

@@ -1,11 +1,11 @@
 import fs from 'fs'
 import yaml from 'js-yaml'
-import cliCommonSections from '../../../../spec/common-cli-sections.json' assert { type: 'json' }
+import cliCommonSections from '../../spec/common-cli-sections.json' assert { type: 'json' }
 import { flattenSections } from '../helpers.mjs'
 
 const flatCLISections = flattenSections(cliCommonSections)
 
-const cliSpec = yaml.load(fs.readFileSync(`../../spec/cli_v1_commands.yaml`, 'utf8'))
+const cliSpec = yaml.load(fs.readFileSync(`spec/cli_v1_commands.yaml`, 'utf8'))
 
 export function generateCLIPages() {
   let cliPages = []

apps/docs/internals/files/reference-lib.mjs

@@ -1,7 +1,7 @@
 import fs from 'fs'
 
 import yaml from 'js-yaml'
-import commonLibSections from '../../../../spec/common-client-libs-sections.json' assert { type: 'json' }
+import commonLibSections from '../../spec/common-client-libs-sections.json' assert { type: 'json' }
 import { flattenSections } from '../helpers.mjs'
 
 const flatCommonLibSections = flattenSections(commonLibSections)
@@ -18,7 +18,7 @@ const clientLibFiles = [
 export function generateReferencePages() {
   let refPages = []
   clientLibFiles.map((file) => {
-    const spec = yaml.load(fs.readFileSync(`../../spec/${file.fileName}.yml`, 'utf8'))
+    const spec = yaml.load(fs.readFileSync(`spec/${file.fileName}.yml`, 'utf8'))
     spec.functions.map((fn) => {
       const slug = flatCommonLibSections.find((item) => item.id === fn.id)?.slug
       refPages.push(`reference/${file.label}/${file.versionSlug ? file.version + '/' : ''}${slug}`)

apps/docs/lib/mdx/getConfig.tsx

@@ -1,8 +1,8 @@
-import specStorageV0 from '~/../../spec/storage_v0_config.yaml' assert { type: 'yml' }
-import specRealtimeV0 from '~/../../spec/realtime_v0_config.yaml' assert { type: 'yml' }
-import specAuthV1 from '~/../../spec/gotrue_v1_config.yaml' assert { type: 'yml' }
-import specAnalyticsV0 from '~/../../spec/analytics_v0_config.yaml' assert { type: 'yml' }
-import specFunctionsV0 from '~/../../spec/functions_v0_config.yaml' assert { type: 'yml' }
+import specStorageV0 from '~/spec/storage_v0_config.yaml' assert { type: 'yml' }
+import specRealtimeV0 from '~/spec/realtime_v0_config.yaml' assert { type: 'yml' }
+import specAuthV1 from '~/spec/gotrue_v1_config.yaml' assert { type: 'yml' }
+import specAnalyticsV0 from '~/spec/analytics_v0_config.yaml' assert { type: 'yml' }
+import specFunctionsV0 from '~/spec/functions_v0_config.yaml' assert { type: 'yml' }
 
 function getStorageConfigV0() {
   return { ...specStorageV0 }

apps/docs/pages/guides/cli/config.tsx

@@ -1,4 +1,4 @@
-import specFile from '~/../../spec/cli_v1_config.yaml' assert { type: 'yml' }
+import specFile from '~/spec/cli_v1_config.yaml' assert { type: 'yml' }
 import { Parameter } from '~/lib/refGenerator/refTypes'
 import ReactMarkdown from 'react-markdown'
 import GuidesTableOfContents from '~/components/GuidesTableOfContents'

apps/docs/pages/reference/analytics/[...slug].tsx

@@ -1,4 +1,4 @@
-import specFile from '~/../../spec/transforms/analytics_v0_openapi_deparsed.json' assert { type: 'json' }
+import specFile from '~/spec/transforms/analytics_v0_openapi_deparsed.json' assert { type: 'json' }
 import { gen_v3, enrichedOperation } from '~/lib/refGenerator/helpers'
 import { Tabs, CodeBlock } from 'ui'
 

apps/docs/pages/reference/analytics/config.tsx

@@ -4,7 +4,7 @@ import components from '~/components/index'
 import { MDXRemote } from 'next-mdx-remote'
 import { serialize } from 'next-mdx-remote/serialize'
 
-import specFile from '~/../../spec/analytics_v0_config.yaml' assert { type: 'yml' }
+import specFile from '~/spec/analytics_v0_config.yaml' assert { type: 'yml' }
 import { Parameter } from '~/lib/refGenerator/refTypes'
 
 import ReactMarkdown from 'react-markdown'

apps/docs/pages/reference/api/[...slug].tsx

@@ -1,5 +1,5 @@
-import apiCommonSections from '~/../../spec/common-api-sections.json' assert { type: 'json' }
-import specFile from '~/../../spec/transforms/api_v0_openapi_deparsed.json' assert { type: 'json' }
+import apiCommonSections from '~/spec/common-api-sections.json' assert { type: 'json' }
+import specFile from '~/spec/transforms/api_v0_openapi_deparsed.json' assert { type: 'json' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/auth/[...slug].tsx

@@ -1,5 +1,5 @@
 import { CodeBlock, Tabs } from 'ui'
-import specFile from '~/../../spec/transforms/auth_v1_openapi_deparsed.json' assert { type: 'json' }
+import specFile from '~/spec/transforms/auth_v1_openapi_deparsed.json' assert { type: 'json' }
 import { gen_v3 } from '~/lib/refGenerator/helpers'
 
 import RefSubLayout from '~/layouts/ref/RefSubLayout'

apps/docs/pages/reference/auth/config.tsx

@@ -1,4 +1,4 @@
-import specFile from '~/../../spec/gotrue_v1_config.yaml' assert { type: 'yml' }
+import specFile from '~/spec/gotrue_v1_config.yaml' assert { type: 'yml' }
 import { Parameter } from '~/lib/refGenerator/refTypes'
 import ReactMarkdown from 'react-markdown'
 import Head from 'next/head'

apps/docs/pages/reference/cli/[...slug].tsx

@@ -1,8 +1,8 @@
-import spec from '~/../../spec/cli_v1_commands.yaml' assert { type: 'yml' }
+import spec from '~/spec/cli_v1_commands.yaml' assert { type: 'yml' }
 
 import { flattenSections } from '~/lib/helpers'
 
-import cliCommonSections from '~/../../spec/common-cli-sections.json' assert { type: 'json' }
+import cliCommonSections from '~/spec/common-cli-sections.json' assert { type: 'json' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'
 import handleRefStaticProps from '~/lib/mdx/handleRefStaticProps'

apps/docs/pages/reference/csharp/[...slug].tsx

@@ -1,5 +1,5 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import spec from '~/../../spec/supabase_csharp_v0.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import spec from '~/spec/supabase_csharp_v0.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/csharp/crawlers/[...slug].tsx

@@ -1,6 +1,6 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import typeSpec from '~/../../spec/enrichments/tsdoc_v2/combined.json'
-import spec from '~/../../spec/supabase_csharp_v0.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import typeSpec from '~/spec/enrichments/tsdoc_v2/combined.json'
+import spec from '~/spec/supabase_csharp_v0.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/csharp/v0/[...slug].tsx

@@ -1,5 +1,5 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import spec from '~/../../spec/supabase_csharp_v0.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import spec from '~/spec/supabase_csharp_v0.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/csharp/v0/crawlers/[...slug].tsx

@@ -1,6 +1,6 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import typeSpec from '~/../../spec/enrichments/tsdoc_v2/combined.json'
-import spec from '~/../../spec/supabase_csharp_v0.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import typeSpec from '~/spec/enrichments/tsdoc_v2/combined.json'
+import spec from '~/spec/supabase_csharp_v0.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/dart/[...slug].tsx

@@ -1,5 +1,5 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import spec from '~/../../spec/supabase_dart_v2.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import spec from '~/spec/supabase_dart_v2.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/dart/crawlers/[...slug].tsx

@@ -1,6 +1,6 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import typeSpec from '~/../../spec/enrichments/tsdoc_v2/combined.json'
-import spec from '~/../../spec/supabase_dart_v2.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import typeSpec from '~/spec/enrichments/tsdoc_v2/combined.json'
+import spec from '~/spec/supabase_dart_v2.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/dart/v1/[...slug].tsx

@@ -1,5 +1,5 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import spec from '~/../../spec/supabase_dart_v1.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import spec from '~/spec/supabase_dart_v1.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/dart/v1/crawlers/[...slug].tsx

@@ -1,6 +1,6 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import typeSpec from '~/../../spec/enrichments/tsdoc_v2/combined.json'
-import spec from '~/../../spec/supabase_dart_v1.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import typeSpec from '~/spec/enrichments/tsdoc_v2/combined.json'
+import spec from '~/spec/supabase_dart_v1.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/javascript/[...slug].tsx

@@ -1,6 +1,6 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import typeSpec from '~/../../spec/enrichments/tsdoc_v2/combined.json'
-import spec from '~/../../spec/supabase_js_v2.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import typeSpec from '~/spec/enrichments/tsdoc_v2/combined.json'
+import spec from '~/spec/supabase_js_v2.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/javascript/crawlers/[...slug].tsx

@@ -1,6 +1,6 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import typeSpec from '~/../../spec/enrichments/tsdoc_v2/combined.json'
-import spec from '~/../../spec/supabase_js_v2.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import typeSpec from '~/spec/enrichments/tsdoc_v2/combined.json'
+import spec from '~/spec/supabase_js_v2.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/javascript/v1/[...slug].tsx

@@ -1,6 +1,6 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import typeSpec from '~/../../spec/enrichments/tsdoc_v1/combined.json'
-import spec from '~/../../spec/supabase_js_v1.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import typeSpec from '~/spec/enrichments/tsdoc_v1/combined.json'
+import spec from '~/spec/supabase_js_v1.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/javascript/v1/crawlers/[...slug].tsx

@@ -1,6 +1,6 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import typeSpec from '~/../../spec/enrichments/tsdoc_v2/combined.json'
-import spec from '~/../../spec/supabase_js_v1.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import typeSpec from '~/spec/enrichments/tsdoc_v2/combined.json'
+import spec from '~/spec/supabase_js_v1.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/kotlin/[...slug].tsx

@@ -1,5 +1,5 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import spec from '~/../../spec/supabase_kt_v2.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import spec from '~/spec/supabase_kt_v2.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/kotlin/crawlers/[...slug].tsx

@@ -1,6 +1,6 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import typeSpec from '~/../../spec/enrichments/tsdoc_v2/combined.json'
-import spec from '~/../../spec/supabase_kt_v2.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import typeSpec from '~/spec/enrichments/tsdoc_v2/combined.json'
+import spec from '~/spec/supabase_kt_v2.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/kotlin/v1/[...slug].tsx

@@ -1,5 +1,5 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import spec from '~/../../spec/supabase_kt_v1.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import spec from '~/spec/supabase_kt_v1.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/kotlin/v1/crawlers/[...slug].tsx

@@ -1,6 +1,6 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import typeSpec from '~/../../spec/enrichments/tsdoc_v2/combined.json'
-import spec from '~/../../spec/supabase_kt_v1.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import typeSpec from '~/spec/enrichments/tsdoc_v2/combined.json'
+import spec from '~/spec/supabase_kt_v1.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/python/[...slug].tsx

@@ -1,6 +1,6 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import typeSpec from '~/../../spec/enrichments/tsdoc_v2/combined.json'
-import spec from '~/../../spec/supabase_py_v2.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import typeSpec from '~/spec/enrichments/tsdoc_v2/combined.json'
+import spec from '~/spec/supabase_py_v2.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/python/crawlers/[...slug].tsx

@@ -1,6 +1,6 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import typeSpec from '~/../../spec/enrichments/tsdoc_v2/combined.json'
-import spec from '~/../../spec/supabase_py_v2.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import typeSpec from '~/spec/enrichments/tsdoc_v2/combined.json'
+import spec from '~/spec/supabase_py_v2.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/realtime/config.tsx

@@ -4,7 +4,7 @@ import components from '~/components/index'
 import { MDXRemote } from 'next-mdx-remote'
 import { serialize } from 'next-mdx-remote/serialize'
 
-import specFile from '~/../../spec/realtime_v0_config.yaml' assert { type: 'yml' }
+import specFile from '~/spec/realtime_v0_config.yaml' assert { type: 'yml' }
 import { Parameter } from '~/lib/refGenerator/refTypes'
 
 import ReactMarkdown from 'react-markdown'

apps/docs/pages/reference/self-hosting-analytics/[...slug].tsx

@@ -1,5 +1,5 @@
-import analyticsSpec from '~/../../spec/transforms/analytics_v0_openapi_deparsed.json' assert { type: 'json' }
-import selfHostingAnalyticsCommonSections from '~/../../spec/common-self-hosting-analytics-sections.json'
+import analyticsSpec from '~/spec/transforms/analytics_v0_openapi_deparsed.json' assert { type: 'json' }
+import selfHostingAnalyticsCommonSections from '~/spec/common-self-hosting-analytics-sections.json'
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/self-hosting-auth/[...slug].tsx

@@ -1,5 +1,5 @@
-import authSpec from '~/../../spec/auth_v1_openapi.json' assert { type: 'json' }
-import selfHostingAuthCommonSections from '~/../../spec/common-self-hosting-auth-sections.json'
+import authSpec from '~/spec/auth_v1_openapi.json' assert { type: 'json' }
+import selfHostingAuthCommonSections from '~/spec/common-self-hosting-auth-sections.json'
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/self-hosting-functions/[...slug].tsx

@@ -1,4 +1,4 @@
-import selfHostingFunctionsCommonSections from '~/../../spec/common-self-hosting-functions-sections.json'
+import selfHostingFunctionsCommonSections from '~/spec/common-self-hosting-functions-sections.json'
 
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'

apps/docs/pages/reference/self-hosting-realtime/[...slug].tsx

@@ -1,4 +1,4 @@
-import selfHostingRealtimeCommonSections from '~/../../spec/common-self-hosting-realtime-sections.json'
+import selfHostingRealtimeCommonSections from '~/spec/common-self-hosting-realtime-sections.json'
 
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'

apps/docs/pages/reference/self-hosting-storage/[...slug].tsx

@@ -1,5 +1,5 @@
-import storageSpec from '~/../../spec/storage_v0_openapi.json' assert { type: 'json' }
-import selfHostingStorageCommonSections from '~/../../spec/common-self-hosting-storage-sections.json'
+import storageSpec from '~/spec/storage_v0_openapi.json' assert { type: 'json' }
+import selfHostingStorageCommonSections from '~/spec/common-self-hosting-storage-sections.json'
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/storage/[...slug].tsx

@@ -1,5 +1,5 @@
 import { CodeBlock, Tabs } from 'ui'
-import specFile from '~/../../spec/transforms/storage_v0_openapi_deparsed.json' assert { type: 'json' }
+import specFile from '~/spec/transforms/storage_v0_openapi_deparsed.json' assert { type: 'json' }
 import { gen_v3 } from '~/lib/refGenerator/helpers'
 
 import RefSubLayout from '~/layouts/ref/RefSubLayout'

apps/docs/pages/reference/storage/config.tsx

@@ -1,4 +1,4 @@
-import specFile from '~/../../spec/storage_v0_config.yaml' assert { type: 'yml' }
+import specFile from '~/spec/storage_v0_config.yaml' assert { type: 'yml' }
 import { Parameter } from '~/lib/refGenerator/refTypes'
 
 import ReactMarkdown from 'react-markdown'

apps/docs/pages/reference/swift/[...slug].tsx

@@ -1,5 +1,5 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import spec from '~/../../spec/supabase_swift_v2.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import spec from '~/spec/supabase_swift_v2.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/swift/crawlers/[...slug].tsx

@@ -1,6 +1,6 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import typeSpec from '~/../../spec/enrichments/tsdoc_v2/combined.json'
-import spec from '~/../../spec/supabase_swift_v2.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import typeSpec from '~/spec/enrichments/tsdoc_v2/combined.json'
+import spec from '~/spec/supabase_swift_v2.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/swift/v0/[...slug].tsx

@@ -1,5 +1,5 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import spec from '~/../../spec/supabase_swift_v2.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import spec from '~/spec/supabase_swift_v2.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/pages/reference/swift/v0/crawlers/[...slug].tsx

@@ -1,6 +1,6 @@
-import clientLibsCommonSections from '~/../../spec/common-client-libs-sections.json'
-import typeSpec from '~/../../spec/enrichments/tsdoc_v2/combined.json'
-import spec from '~/../../spec/supabase_swift_v2.yml' assert { type: 'yml' }
+import clientLibsCommonSections from '~/spec/common-client-libs-sections.json'
+import typeSpec from '~/spec/enrichments/tsdoc_v2/combined.json'
+import spec from '~/spec/supabase_swift_v2.yml' assert { type: 'yml' }
 import RefSectionHandler from '~/components/reference/RefSectionHandler'
 import { flattenSections } from '~/lib/helpers'
 import handleRefGetStaticPaths from '~/lib/mdx/handleRefStaticPaths'

apps/docs/public/sitemap.xml

@@ -187,7 +187,7 @@
   </url>
 
   <url>
-    <loc>https://supabase.com/docs/guides/api/joins-and-nesting</loc>
+    <loc>https://supabase.com/docs/guides/api/data-apis</loc>
     <changefreq>weekly</changefreq>
     <changefreq>0.5</changefreq>
   </url>
@@ -234,6 +234,18 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/guides/auth/auth-hooks</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/auth/auth-identity-linking</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/guides/auth/auth-mfa</loc>
     <changefreq>weekly</changefreq>
@@ -252,6 +264,12 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/guides/auth/auth-user-management</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/guides/auth/enterprise-sso</loc>
     <changefreq>weekly</changefreq>
@@ -282,6 +300,12 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/guides/auth/passwords</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/guides/auth/phone-login</loc>
     <changefreq>weekly</changefreq>
@@ -312,48 +336,6 @@
     <changefreq>0.5</changefreq>
   </url>
 
-  <url>
-    <loc>https://supabase.com/docs/guides/cli/customizing-email-templates</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/cli/getting-started</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/cli/local-development</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/cli/managing-config</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/cli/managing-environments</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/cli/seeding-your-database</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/cli/testing-and-linting</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
   <url>
     <loc>https://supabase.com/docs/guides/database/arrays</loc>
     <changefreq>weekly</changefreq>
@@ -366,6 +348,12 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/guides/database/debugging-performance</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/guides/database/extensions</loc>
     <changefreq>weekly</changefreq>
@@ -384,6 +372,12 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/guides/database/import-data</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/guides/database/inspect</loc>
     <changefreq>weekly</changefreq>
@@ -391,13 +385,13 @@
   </url>
 
   <url>
-    <loc>https://supabase.com/docs/guides/database/json</loc>
+    <loc>https://supabase.com/docs/guides/database/joins-and-nesting</loc>
     <changefreq>weekly</changefreq>
     <changefreq>0.5</changefreq>
   </url>
 
   <url>
-    <loc>https://supabase.com/docs/guides/database/large-datasets</loc>
+    <loc>https://supabase.com/docs/guides/database/json</loc>
     <changefreq>weekly</changefreq>
     <changefreq>0.5</changefreq>
   </url>
@@ -438,6 +432,12 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/guides/database/secure-data</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/guides/database/sql-to-api</loc>
     <changefreq>weekly</changefreq>
@@ -576,6 +576,48 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/guides/cli/customizing-email-templates</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/cli/getting-started</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/cli/local-development</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/cli/managing-config</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/cli/managing-environments</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/cli/seeding-your-database</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/cli/testing-and-linting</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/guides/platform/access-control</loc>
     <changefreq>weekly</changefreq>
@@ -642,6 +684,12 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/guides/platform/fly-postgres</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/guides/platform/going-into-prod</loc>
     <changefreq>weekly</changefreq>
@@ -720,6 +768,12 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/guides/platform/read-replicas</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/guides/platform/shared-responsibility-model</loc>
     <changefreq>weekly</changefreq>
@@ -864,12 +918,6 @@
     <changefreq>0.5</changefreq>
   </url>
 
-  <url>
-    <loc>https://supabase.com/docs/guides/ai/integrations/llamaindex</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
   <url>
     <loc>https://supabase.com/docs/guides/ai/examples/building-chatgpt-plugins</loc>
     <changefreq>weekly</changefreq>
@@ -907,13 +955,13 @@
   </url>
 
   <url>
-    <loc>https://supabase.com/docs/guides/ai/vector-indexes/hnsw-indexes</loc>
+    <loc>https://supabase.com/docs/guides/ai/integrations/llamaindex</loc>
     <changefreq>weekly</changefreq>
     <changefreq>0.5</changefreq>
   </url>
 
   <url>
-    <loc>https://supabase.com/docs/guides/ai/vector-indexes/ivf-indexes</loc>
+    <loc>https://supabase.com/docs/guides/ai/integrations/roboflow</loc>
     <changefreq>weekly</changefreq>
     <changefreq>0.5</changefreq>
   </url>
@@ -942,6 +990,18 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/guides/ai/vector-indexes/hnsw-indexes</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/ai/vector-indexes/ivf-indexes</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/guides/api/rest/auto-generated-docs</loc>
     <changefreq>weekly</changefreq>
@@ -954,72 +1014,18 @@
     <changefreq>0.5</changefreq>
   </url>
 
-  <url>
-    <loc>https://supabase.com/docs/guides/api/rest/debugging-performance</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
   <url>
     <loc>https://supabase.com/docs/guides/api/rest/generating-types</loc>
     <changefreq>weekly</changefreq>
     <changefreq>0.5</changefreq>
   </url>
 
-  <url>
-    <loc>https://supabase.com/docs/guides/auth/auth-helpers/auth-ui</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/auth/auth-helpers/flutter-auth-ui</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/auth/auth-helpers/nextjs-pages</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/auth/auth-helpers/nextjs</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/auth/auth-helpers/remix</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/auth/auth-helpers/sveltekit</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
   <url>
     <loc>https://supabase.com/docs/guides/auth/concepts/redirect-urls</loc>
     <changefreq>weekly</changefreq>
     <changefreq>0.5</changefreq>
   </url>
 
-  <url>
-    <loc>https://supabase.com/docs/guides/auth/passwordless-login/auth-email-otp</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/auth/passwordless-login/auth-magic-link</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
   <url>
     <loc>https://supabase.com/docs/guides/auth/phone-login/messagebird</loc>
     <changefreq>weekly</changefreq>
@@ -1088,12 +1094,6 @@
     <changefreq>0.5</changefreq>
   </url>
 
-  <url>
-    <loc>https://supabase.com/docs/guides/auth/sso/auth-sso-saml</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
   <url>
     <loc>https://supabase.com/docs/guides/auth/social-login/auth-apple</loc>
     <changefreq>weekly</changefreq>
@@ -1208,6 +1208,108 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/guides/auth/sso/auth-sso-saml</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/auth/auth-helpers/auth-ui</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/auth/auth-helpers/flutter-auth-ui</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/auth/auth-helpers/nextjs-pages</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/auth/auth-helpers/nextjs</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/auth/auth-helpers/remix</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/auth/auth-helpers/sveltekit</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/database/postgres/cascade-deletes</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/database/postgres/configuration</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/database/postgres/dropping-all-tables-in-schema</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/database/postgres/enums</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/database/postgres/first-row-in-group</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/database/postgres/indexes</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/database/postgres/roles</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/database/postgres/row-level-security</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/database/postgres/triggers</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/database/postgres/which-version-of-postgres</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/guides/database/extensions/http</loc>
     <changefreq>weekly</changefreq>
@@ -1358,66 +1460,6 @@
     <changefreq>0.5</changefreq>
   </url>
 
-  <url>
-    <loc>https://supabase.com/docs/guides/database/postgres/cascade-deletes</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/database/postgres/configuration</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/database/postgres/dropping-all-tables-in-schema</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/database/postgres/enums</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/database/postgres/first-row-in-group</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/database/postgres/indexes</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/database/postgres/roles</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/database/postgres/row-level-security</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/database/postgres/triggers</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
-  <url>
-    <loc>https://supabase.com/docs/guides/database/postgres/which-version-of-postgres</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
   <url>
     <loc>https://supabase.com/docs/guides/getting-started/quickstarts/flutter</loc>
     <changefreq>weekly</changefreq>
@@ -1688,12 +1730,6 @@
     <changefreq>0.5</changefreq>
   </url>
 
-  <url>
-    <loc>https://supabase.com/docs/guides/self-hosting/analytics/config</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
   <url>
     <loc>https://supabase.com/docs/guides/resources/migrating-to-supabase/amazon-rds</loc>
     <changefreq>weekly</changefreq>
@@ -1748,6 +1784,12 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/guides/self-hosting/analytics/config</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/guides/self-hosting/auth/config</loc>
     <changefreq>weekly</changefreq>
@@ -1760,6 +1802,18 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/guides/auth/passwordless-login/auth-email-otp</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/guides/auth/passwordless-login/auth-magic-link</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/guides/self-hosting/storage/config</loc>
     <changefreq>weekly</changefreq>
@@ -1808,6 +1862,12 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/guides/storage/production/scaling</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/guides/storage/schema/design</loc>
     <changefreq>weekly</changefreq>
@@ -1820,12 +1880,6 @@
     <changefreq>0.5</changefreq>
   </url>
 
-  <url>
-    <loc>https://supabase.com/docs/guides/storage/production/scaling</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
   <url>
     <loc>https://supabase.com/docs/guides/storage/security/access-control</loc>
     <changefreq>weekly</changefreq>
@@ -1886,6 +1940,12 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/reference/javascript/auth-onauthstatechange</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/reference/javascript/auth-signinwithpassword</loc>
     <changefreq>weekly</changefreq>
@@ -1946,6 +2006,24 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/reference/javascript/auth-getuseridentities</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/reference/javascript/auth-linkidentity</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/reference/javascript/auth-unlinkidentity</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/reference/javascript/auth-reauthentication</loc>
     <changefreq>weekly</changefreq>
@@ -1970,12 +2048,6 @@
     <changefreq>0.5</changefreq>
   </url>
 
-  <url>
-    <loc>https://supabase.com/docs/reference/javascript/auth-onauthstatechange</loc>
-    <changefreq>weekly</changefreq>
-    <changefreq>0.5</changefreq>
-  </url>
-
   <url>
     <loc>https://supabase.com/docs/reference/javascript/auth-exchangecodeforsession</loc>
     <changefreq>weekly</changefreq>
@@ -2507,7 +2579,7 @@
   </url>
 
   <url>
-    <loc>https://supabase.com/docs/reference/dart/sign-in-with-apple</loc>
+    <loc>https://supabase.com/docs/reference/dart/auth-signinwithidtoken</loc>
     <changefreq>weekly</changefreq>
     <changefreq>0.5</changefreq>
   </url>
@@ -4204,6 +4276,18 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/reference/kotlin/using-modifiers</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/reference/kotlin/db-modifiers-select</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/reference/kotlin/order</loc>
     <changefreq>weekly</changefreq>
@@ -4222,6 +4306,24 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/reference/kotlin/single</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/reference/kotlin/db-csv</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/reference/kotlin/explain</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/reference/kotlin/auth-api</loc>
     <changefreq>weekly</changefreq>
@@ -4300,6 +4402,24 @@
     <changefreq>0.5</changefreq>
   </url>
 
+  <url>
+    <loc>https://supabase.com/docs/reference/kotlin/auth-getuseridentities</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/reference/kotlin/auth-linkidentity</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
+  <url>
+    <loc>https://supabase.com/docs/reference/kotlin/auth-unlinkidentity</loc>
+    <changefreq>weekly</changefreq>
+    <changefreq>0.5</changefreq>
+  </url>
+
   <url>
     <loc>https://supabase.com/docs/reference/kotlin/auth-setsession</loc>
     <changefreq>weekly</changefreq>

apps/docs/scripts/search/sources/index.ts

@@ -31,64 +31,64 @@ export async function fetchSources() {
     'api',
     '/reference/api',
     { title: 'Management API Reference' },
-    '../../spec/transforms/api_v0_openapi_deparsed.json',
-    '../../spec/common-api-sections.json'
+    'spec/transforms/api_v0_openapi_deparsed.json',
+    'spec/common-api-sections.json'
   ).load()
 
   const jsLibReferenceSource = new ClientLibReferenceLoader(
     'js-lib',
     '/reference/javascript',
     { title: 'JavaScript Reference' },
-    '../../spec/supabase_js_v2.yml',
-    '../../spec/common-client-libs-sections.json'
+    'spec/supabase_js_v2.yml',
+    'spec/common-client-libs-sections.json'
   ).load()
 
   const dartLibReferenceSource = new ClientLibReferenceLoader(
     'dart-lib',
     '/reference/dart',
     { title: 'Dart Reference' },
-    '../../spec/supabase_dart_v2.yml',
-    '../../spec/common-client-libs-sections.json'
+    'spec/supabase_dart_v2.yml',
+    'spec/common-client-libs-sections.json'
   ).load()
 
   const pythonLibReferenceSource = new ClientLibReferenceLoader(
     'python-lib',
     '/reference/python',
     { title: 'Python Reference' },
-    '../../spec/supabase_py_v2.yml',
-    '../../spec/common-client-libs-sections.json'
+    'spec/supabase_py_v2.yml',
+    'spec/common-client-libs-sections.json'
   ).load()
 
   const cSharpLibReferenceSource = new ClientLibReferenceLoader(
     'csharp-lib',
     '/reference/csharp',
     { title: 'C# Reference' },
-    '../../spec/supabase_csharp_v0.yml',
-    '../../spec/common-client-libs-sections.json'
+    'spec/supabase_csharp_v0.yml',
+    'spec/common-client-libs-sections.json'
   ).load()
 
   const swiftLibReferenceSource = new ClientLibReferenceLoader(
     'swift-lib',
     '/reference/swift',
     { title: 'Swift Reference' },
-    '../../spec/supabase_swift_v2.yml',
-    '../../spec/common-client-libs-sections.json'
+    'spec/supabase_swift_v2.yml',
+    'spec/common-client-libs-sections.json'
   ).load()
 
   const ktLibReferenceSource = new ClientLibReferenceLoader(
     'kt-lib',
     '/reference/kotlin',
     { title: 'Kotlin Reference' },
-    '../../spec/supabase_kt_v1.yml',
-    '../../spec/common-client-libs-sections.json'
+    'spec/supabase_kt_v1.yml',
+    'spec/common-client-libs-sections.json'
   ).load()
 
   const cliReferenceSource = new CliReferenceLoader(
     'cli',
     '/reference/cli',
     { title: 'CLI Reference' },
-    '../../spec/cli_v1_commands.yaml',
-    '../../spec/common-cli-sections.json'
+    'spec/cli_v1_commands.yaml',
+    'spec/common-cli-sections.json'
   ).load()
 
   const guideSources = (await walk('pages'))