New Supabase Docs, built with Next.js

Summary

Supabase released a new version of its documentation, rebuilding the site with Next.js after outgrowing Docusaurus. The earlier setup became harder to maintain as client-library versioning expanded, contributions grew more difficult, and the docs remained separate from Supabase’s Next.js and Turborepo monorepo. To reduce migration risk, the team first created a one-week Next.js MVP that copied Docusaurus, then spent a month developing the new release with two full-time developers. It introduces a new design, a single sidebar for broader discoverability, and reference pages that group all functions in a library while improving TypeDoc-based generation. Future work described includes unified authentication, project-specific documentation, runnable Postgres WASM examples, interactive tutorials, improved Postgres full-text search, and balancing sparse and overly verbose content.

Takeaways

1. 1

   The initial Next.js migration succeeded by treating it as an MVP and reproducing the existing Docusaurus experience instead of attempting a broader redesign.

2. 2

   The new reference layout places all functions from a library on one page, allowing discovery through the site search or the browser’s find command.

3. 3

   Planned additions include unified authentication, project-specific URLs and keys in documentation, runnable Postgres WASM examples, interactive tutorials, and Postgres full-text search.