mirror of
https://github.com/supabase/supabase.git
synced 2026-05-07 09:20:21 -04:00
Charis
fc164b5d07
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.
63 lines
2.3 KiB
TypeScript
63 lines
2.3 KiB
TypeScript
import Link from 'next/link'
|
|
|
|
import { REFERENCES, clientSdkIds } from '~/content/navigation.references'
|
|
import { IconPanelWithIconPicker } from '~/features/ui/IconPanelWithIconPicker'
|
|
import { LayoutMainContent } from '~/layouts/DefaultLayout'
|
|
import { SidebarSkeleton } from '~/layouts/MainSkeleton'
|
|
|
|
export default function ReferenceIndexPage() {
|
|
return (
|
|
<SidebarSkeleton>
|
|
<LayoutMainContent>
|
|
<article className="prose">
|
|
<h1>API References</h1>
|
|
<p>
|
|
The Supabase client libraries help you interact with Supabase products, such as the
|
|
Postgres Database, Auth, and Realtime. They are available in several popular programming
|
|
languages.
|
|
</p>
|
|
<p>
|
|
Supabase also has a Management API to help with managing your Supabase Platform, and a
|
|
CLI for local development and CI workflows.
|
|
</p>
|
|
<h2 className="mb-8">Client Libraries</h2>
|
|
<div className="grid col-span-8 grid-cols-12 gap-6 not-prose">
|
|
{clientSdkIds.map((sdkId) => {
|
|
return (
|
|
<Link
|
|
key={REFERENCES[sdkId].name}
|
|
href={`/reference/${REFERENCES[sdkId].libPath}`}
|
|
passHref
|
|
className="col-span-6 md:col-span-4"
|
|
>
|
|
<IconPanelWithIconPicker
|
|
title={REFERENCES[sdkId].name}
|
|
icon={REFERENCES[sdkId].icon}
|
|
/>
|
|
</Link>
|
|
)
|
|
})}
|
|
</div>
|
|
<h2 className="mb-8">Management API and CLI</h2>
|
|
<div className="grid col-span-8 grid-cols-12 gap-6 not-prose">
|
|
<Link
|
|
href={`/reference/api/introduction`}
|
|
passHref
|
|
className="col-span-6 md:col-span-4"
|
|
>
|
|
<IconPanelWithIconPicker title="Management API" icon={REFERENCES['api'].icon} />
|
|
</Link>
|
|
<Link
|
|
href={`/reference/cli/introduction`}
|
|
passHref
|
|
className="col-span-6 md:col-span-4"
|
|
>
|
|
<IconPanelWithIconPicker title="CLI" icon={REFERENCES['cli'].icon} />
|
|
</Link>
|
|
</div>
|
|
</article>
|
|
</LayoutMainContent>
|
|
</SidebarSkeleton>
|
|
)
|
|
}
|