Supabase Docs

Overview

This is a single repository for two different websites. Our documents were created with docusaurus and are stored in the web folder. Our beta website can be found in the www folder. This is a standard Next.js website.

The beta website has a basePath of new and is built with vercel.json. This is done to distinguish between HTTP requests from both websites. Any request with a path that begins with /new/ will be routed to the beta website.

Install the Vercel CLI.

To execute this locally, run the following commands. This will launch the website at http://localhost:8080/, and requests will be automatically proxied (through vercel rewrites) to the docs website (running at http://localhost:3005/) and the beta website (running at http://localhost:3000).

# tab 1
make dev

# tab 2
cd www
npm install
npm run dev

# tab 3
cd web/spec
make
npm install
npm run gen:supabase
npm run start

In production, this setup is deployed as three different vercel websites (docs, www and main).

Known issues

• Some hardcoding of /new in www. Should be fine as long as the basePath doesn't change.
• Referencing resources in nested folders may not work for web (eg /web/static/folder/nestedfolder/asset) may not work.
• Don't use Link since that adds /new to the links. Use plain a tags when possible.