---
number: 39197
slug: 39197-supabase-js-client-libs-migration-to-monorepo
published: 2025-10-02
discussion: https://github.com/orgs/supabase/discussions/39197
labels:
  - javascript
page: https://supabase.com/changelog/39197-supabase-js-client-libs-migration-to-monorepo
---

# Supabase JS Client Libs: Migration to Monorepo

## What Changed

We've consolidated all Supabase JS client libraries into a unified monorepo at **[supabase/supabase-js](https://github.com/supabase/supabase-js)**.

### For Package Users 👥

**Nothing changed for you!** Continue installing packages as usual:

```bash
npm install @supabase/supabase-js
npm install @supabase/auth-js
npm install @supabase/storage-js
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](https://github.com/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](https://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:
- **[Contributing Guide](https://github.com/supabase/supabase-js/blob/master/CONTRIBUTING.md)** - Development workflow and PR process
- **[Migration Guide](https://github.com/supabase/supabase-js/blob/master/docs/MIGRATION.md)** - Detailed transition information
- **[Testing Guide](https://github.com/supabase/supabase-js/blob/master/docs/TESTING.md)** - Package-specific testing requirements

## Questions?

- **Issues**: [supabase-js Issues](https://github.com/supabase/supabase-js/issues)
- **Migration help**: Open a [new issue](https://github.com/supabase/supabase-js/issues/new/choose). Add `[migration]` in the title of your issue.