Supabase JS Client Libs: Migration to Monorepo

Oct 2, 2025

What Changed#

We've consolidated all Supabase JS client libraries into a unified monorepo at supabase/supabase-js.

For Package Users 👥#

Nothing changed for you! Continue installing packages as usual:


_10
npm install @supabase/supabase-js
_10
npm install @supabase/auth-js
_10
npm install @supabase/storage-js
_10
etc.

For Contributors 🛠️#

All development now happens in the monorepo:

Old repositories (will be archived soon):

  • supabase/auth-js
  • supabase/postgrest-js
  • supabase/realtime-js
  • supabase/storage-js
  • supabase/functions-js

New location: All libraries are now under packages/core/ in supabase/supabase-js

Benefits#

  • Fixed versioning - all packages share the same version for compatibility
  • Atomic changes - fix bugs across libraries in single PRs
  • Better testing - immediate integration testing without manual releases
  • Unified tooling - consistent build, test, and release processes

Getting Started#

  1. Fork and clone: github.com/supabase/supabase-js
  2. Read the guides: Complete documentation in the new repository
  3. Use Nx commands: npx nx test auth-js, npx nx build storage-js, etc.

Documentation#

All documentation is now in the monorepo:

Questions?#

Build in a weekend, scale to millions