mirror of
https://github.com/supabase/supabase.git
synced 2026-05-23 19:13:13 +08:00
Migrates client SDK References to App Router. (Management and CLI API references aren't migrated yet, nor are self-hosting config references.) Some notes: Big changes to the way crawler pages are built and individual section URLs (e.g., javascript/select) are served. All of these used to be SSG-generated pages, but the number of heavy pages was just too much to handle -- slow as molasses and my laptop sounded like it was taking off, and CI sometimes refuses to build it all at all. Tried various tricks with caching and pre-generating data but no dice. So I changed to only building one copy of each SDK+version page, then serving the sub-URLs through a response rewrite. That's for the actual user-visible pages. For the bot pages, each sub-URL needs to be its own page, but prebuilding it doesn't work, and rendering on demand from React components is too slow (looking for super-fast response here for SEO). Instead I changed to using an API route that serves very minimal, hand-crafted HTML. It looks ugly, but it's purely for the search bots. You can test what bots see by running curl --user-agent "Mozilla/5.0 (iPhone; CPU iPhone OS 6_0 like Mac OS X) AppleWebKit/536.26 (KHTML, like Gecko) Version/6.0 Mobile/10A5376e Safari/8536.25 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)" <URL_OF_PAGE> Also added some smoke tests to run against prod for the crawler routes, since we don't keep an eye on those regularly, and Vercel config changes could surprise-break them. Tested the meta images on Open Graph and all seems to work fine. With this approach, full production builds are really fast: ~5 minutes Starts using the new type spec handling, which is better at finding params automatically, so I could remove some of the manually written ones from the spec files.
144 lines
3.8 KiB
TypeScript
144 lines
3.8 KiB
TypeScript
'use client'
|
|
|
|
import { useEffect, useState } from 'react'
|
|
import { usePathname } from 'next/navigation'
|
|
import { MenuId } from '~/components/Navigation/NavigationMenu/NavigationMenu'
|
|
import type { ICommonItem } from '~/components/reference/Reference.types'
|
|
import type { Json } from '~/features/helpers.types'
|
|
import { menuState } from '../../../hooks/useMenuState'
|
|
|
|
export function getPathWithoutHash(relativePath: string) {
|
|
return new URL(relativePath, 'http://placeholder').pathname
|
|
}
|
|
|
|
/**
|
|
* Recursively filter common sections and their sub items based on
|
|
* what is available in their spec
|
|
*/
|
|
export function deepFilterSections<T extends ICommonItem>(
|
|
sections: T[],
|
|
specFunctionIds: string[]
|
|
): T[] {
|
|
return sections
|
|
.filter(
|
|
(section) =>
|
|
section.type === 'category' ||
|
|
section.type === 'markdown' ||
|
|
specFunctionIds.includes(section.id)
|
|
)
|
|
.flatMap((section) => {
|
|
if ('items' in section) {
|
|
const items = deepFilterSections(section.items, specFunctionIds)
|
|
|
|
// Only include this category (heading) if it has subitems
|
|
if (items.length > 0) {
|
|
return {
|
|
...section,
|
|
items,
|
|
}
|
|
}
|
|
|
|
return []
|
|
}
|
|
return section
|
|
})
|
|
}
|
|
|
|
/**
|
|
* Imports common sections file dynamically.
|
|
*
|
|
* Dynamic imports allow for code splitting which
|
|
* dramatically reduces app bundle size.
|
|
*
|
|
* See https://webpack.js.org/api/module-methods/#dynamic-expressions-in-import
|
|
*/
|
|
export function useCommonSections(commonSectionsFile: string) {
|
|
const [commonSections, setCommonSections] = useState<ICommonItem[]>()
|
|
|
|
useEffect(() => {
|
|
async function fetchCommonSections() {
|
|
const commonSections = await import(
|
|
/* webpackInclude: /common-.*\.json$/ */
|
|
/* webpackMode: "lazy" */
|
|
`~/spec/${commonSectionsFile}`
|
|
)
|
|
setCommonSections(commonSections.default)
|
|
}
|
|
fetchCommonSections()
|
|
}, [commonSectionsFile])
|
|
|
|
return commonSections
|
|
}
|
|
|
|
/**
|
|
* Imports spec file dynamically.
|
|
*
|
|
* Dynamic imports allow for code splitting which
|
|
* dramatically reduces app bundle size.
|
|
*
|
|
* See https://webpack.js.org/api/module-methods/#dynamic-expressions-in-import
|
|
*/
|
|
export function useSpec(specFile?: string) {
|
|
const [spec, setSpec] = useState<Json>()
|
|
|
|
useEffect(() => {
|
|
if (!specFile) {
|
|
return
|
|
}
|
|
async function fetchSpec() {
|
|
const spec = await import(
|
|
/* webpackInclude: /supabase_.*\.ya?ml$/ */
|
|
/* webpackMode: "lazy" */
|
|
`~/spec/${specFile}`
|
|
)
|
|
setSpec(spec.default)
|
|
}
|
|
fetchSpec()
|
|
}, [specFile])
|
|
|
|
return spec
|
|
}
|
|
|
|
export const getMenuId = (pathname: string | null) => {
|
|
pathname = (pathname ??= '').replace(/^\/guides\//, '')
|
|
|
|
switch (true) {
|
|
case pathname.startsWith('ai'):
|
|
return MenuId.Ai
|
|
case pathname.startsWith('api'):
|
|
return MenuId.Api
|
|
case pathname.startsWith('auth'):
|
|
return MenuId.Auth
|
|
case pathname.startsWith('cli'):
|
|
return MenuId.Cli
|
|
case pathname.startsWith('database'):
|
|
return MenuId.Database
|
|
case pathname.startsWith('functions'):
|
|
return MenuId.Functions
|
|
case pathname.startsWith('getting-started'):
|
|
return MenuId.GettingStarted
|
|
case pathname.startsWith('graphql'):
|
|
return MenuId.Graphql
|
|
case pathname.startsWith('platform'):
|
|
return MenuId.Platform
|
|
case pathname.startsWith('realtime'):
|
|
return MenuId.Realtime
|
|
case pathname.startsWith('resources'):
|
|
return MenuId.Resources
|
|
case pathname.startsWith('self-hosting'):
|
|
return MenuId.SelfHosting
|
|
case pathname.startsWith('storage'):
|
|
return MenuId.Storage
|
|
default:
|
|
return MenuId.GettingStarted
|
|
}
|
|
}
|
|
|
|
export const useCloseMenuOnRouteChange = () => {
|
|
const pathname = usePathname()
|
|
|
|
useEffect(() => {
|
|
menuState.setMenuMobileOpen(false)
|
|
}, [pathname])
|
|
}
|