<br />
<p align="center">
<a href="https://supabase.io">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/supabase/supabase/master/packages/common/assets/images/supabase-logo-wordmark--dark.svg">
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/supabase/supabase/master/packages/common/assets/images/supabase-logo-wordmark--light.svg">
<img alt="Supabase Logo" width="300" src="https://raw.githubusercontent.com/supabase/supabase/master/packages/common/assets/images/logo-preview.jpg">
</picture>
</a>
<h1 align="center">Supabase JS SDK</h1>
<p align="center">
<a href="https://supabase.com/docs/guides/getting-started">Guides</a>
·
<a href="https://supabase.com/docs/reference/javascript/introduction">Reference Docs</a>
</p>
</p>
<div align="center">
[](https://github.com/supabase/supabase-js/actions?query=branch%3Amaster)
[](https://www.npmjs.com/package/@supabase/postgrest-js)
[](#license)
[](https://pkg.pr.new/~/supabase/supabase-js)
</div>
## 📦 Libraries
This monorepo contains the complete suite of Supabase JavaScript SDK:
| Library | Description |
| ---------------------------------------------------------- | ------------------------------------- |
| **[@supabase/supabase-js](./packages/core/supabase-js)** | Main isomorphic SDK for Supabase |
| **[@supabase/auth-js](./packages/core/auth-js)** | Authentication SDK |
| **[@supabase/postgrest-js](./packages/core/postgrest-js)** | PostgREST SDK for database operations |
| **[@supabase/realtime-js](./packages/core/realtime-js)** | Real-time subscriptions SDK |
| **[@supabase/storage-js](./packages/core/storage-js)** | File storage SDK |
| **[@supabase/functions-js](./packages/core/functions-js)** | Edge Functions SDK |
## Support Policy
This section outlines the scope of support for various runtime environments in Supabase JavaScript client.
### Node.js
We only support Node.js versions that are in **Active LTS** or **Maintenance** status as defined by the [official Node.js release schedule](https://nodejs.org/en/about/previous-releases#release-schedule). This means we support versions that are currently receiving long-term support and critical bug fixes.
When a Node.js version reaches end-of-life and is no longer in Active LTS or Maintenance status, Supabase will drop it in a **minor release**, and **this won't be considered a breaking change**.
> ⚠️ **Node.js 18 Deprecation Notice**
>
> Node.js 18 reached end-of-life on April 30, 2025. As announced in [our deprecation notice](https://github.com/orgs/supabase/discussions/37217), support for Node.js 18 was dropped in version `2.79.0`.
>
> If you must use Node.js 18, please use version `2.78.0`, which is the last version that supported Node.js 18.
> ⚠️ **Node.js 20 Deprecation Notice**
>
> Node.js 20 reached end-of-life on April 30, 2026. As announced in [our deprecation notice](https://github.com/orgs/supabase/discussions/45715), support for Node.js 20 was dropped in version `2.110.0`.
>
> If you must use Node.js 20, please use version `2.109.0`, which is the last version that supported Node.js 20.
### Deno
We support Deno versions that are currently receiving active development and security updates. We follow the [official Deno release schedule](https://docs.deno.com/runtime/fundamentals/stability_and_releases/) and only support versions from the `stable` and `lts` release channels.
When a Deno version reaches end-of-life and is no longer receiving security updates, Supabase will drop it in a **minor release**, and **this won't be considered a breaking change**.
### Browsers
All modern browsers are supported. We support browsers that provide native `fetch` API. For Realtime features, browsers must also support native `WebSocket` API.
### Bun
We support Bun runtime environments. Bun provides native fetch support and is compatible with Node.js APIs. Since Bun does not follow a structured release schedule like Node.js or Deno, we support current stable versions of Bun and may drop support for older versions in minor releases without considering it a breaking change.
### React Native
We support React Native environments with fetch polyfills provided by the framework. Since React Native does not follow a structured release schedule, we support current stable versions and may drop support for older versions in minor releases without considering it a breaking change.
### Cloudflare Workers
We support Cloudflare Workers runtime environments. Cloudflare Workers provides native fetch support. Since Cloudflare Workers does not follow a structured release schedule, we support current stable versions and may drop support for older versions in minor releases without considering it a breaking change.
### Important Notes
- **Experimental features**: Features marked as experimental may be removed or changed without notice
- **Build warnings**: If you see `UNUSED_EXTERNAL_IMPORT` warnings from Vite/Nuxt, see the [supabase-js README](./packages/core/supabase-js/README.md#known-build-warnings) — these are false positives
## Supabase Service Compatibility
The Supabase JavaScript SDK only guarantees compatibility with the latest
release of each Supabase service, unless a minimum supported version is
explicitly listed below.
Older service releases are supported on a best-effort basis, but compatibility
is not guaranteed.
If you self-host Supabase, we recommend upgrading your services to their latest
releases when upgrading the SDK.
| Service | SDK package | Server releases | Lowest supported version |
| --------- | -------------------------------------------------------- | -------------------------------------------------------------------------- | ------------------------ |
| Auth | [`@supabase/auth-js`](./packages/core/auth-js) | [supabase/auth](https://github.com/supabase/auth/releases) | Latest release |
| Storage | [`@supabase/storage-js`](./packages/core/storage-js) | [supabase/storage](https://github.com/supabase/storage/releases) | Latest release |
| Functions | [`@supabase/functions-js`](./packages/core/functions-js) | [supabase/edge-runtime](https://github.com/supabase/edge-runtime/releases) | Latest release |
| PostgREST | [`@supabase/postgrest-js`](./packages/core/postgrest-js) | [PostgREST/postgrest](https://github.com/PostgREST/postgrest/releases) | v12 |
| Realtime | [`@supabase/realtime-js`](./packages/core/realtime-js) | [supabase/realtime](https://github.com/supabase/realtime/releases) | Latest release |
Where a lowest supported version is listed, some features still need a newer
server version. Those requirements are noted in the API reference for the
feature.
## 🚀 Quick Start
### Installation
```bash
npm install @supabase/supabase-js
```
Read more in each package's README file.
## 🤝 Contributing
We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.
### Quick Contribution Steps
1. **Fork the repository**
2. **Create a feature branch** (`git checkout -b feature/amazing-feature`)
3. **Make your changes** and add tests
4. **Run tests** (`pnpm nx affected --target=test`)
5. **Commit your changes** (`pnpm commit`)
6. **Push to your branch** (`git push origin feature/amazing-feature`)
7. **Open a Pull Request**
### Development Guidelines
- Follow [conventional commits](https://www.conventionalcommits.org/) for commit messages
- Add tests for new functionality
- Update documentation for API changes
- Run `pnpm nx format` before committing
- Ensure all tests pass with `pnpm nx affected --target=test`
## 🧪 Testing
Testing varies per package. See the top-level [TESTING.md](docs/TESTING.md) for an overview and links to package-specific guides.
## 📚 Documentation
### API Documentation
- **[Auth SDK](./packages/core/auth-js/README.md)** - Authentication and user management
- **[Database SDK](./packages/core/postgrest-js/README.md)** - Database queries and operations
- **[Realtime SDK](./packages/core/realtime-js/README.md)** - Real-time subscriptions
- **[Storage SDK](./packages/core/storage-js/README.md)** - File upload and management
- **[Functions SDK](./packages/core/functions-js/README.md)** - Edge Functions invocation
- **[Main SDK](./packages/core/supabase-js/README.md)** - Combined SDK
### Architecture Documentation
- **[Contributing](./CONTRIBUTING.md)** - Development guidelines
- **[Release Workflows](./docs/RELEASE.md)** - Release and publishing process
- **[Migration Guide](./docs/MIGRATION.md)** - Cross-cutting migration notes (per-package migrations live alongside each package under `packages/core/<package>/migrations/`)
- **[Security Policy](https://github.com/supabase/supabase-js/security/policy)** - Vulnerability reporting and disclosure policy
- **[Securing your npm installs](https://supabase.com/docs/guides/security/npm-security)** - Consumer-side guide to defending your install against npm supply-chain attacks
## 🔐 Verifying provenance attestations
You can verify registry signatures and provenance attestations for installed packages using the npm CLI:
```bash
npm audit signatures
```
Quick example for a single package install:
```bash
npm install @supabase/auth-js
npm audit signatures
```
Example output:
```text
audited 1 package in 0s
1 package has a verified registry signature
```
Because provenance attestations are a new capability, security features may evolve over time. Ensure you are using the latest npm CLI to verify attestation signatures reliably. This may require updating npm beyond the version bundled with Node.js.
For a broader checklist — minimum release age, lockfile hygiene, blocking exotic transitive deps, lifecycle script controls, and what to do if you suspect a compromise — see [Securing your npm installs](https://supabase.com/docs/guides/security/npm-security).
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
## 🆘 Support
- **Documentation**: [supabase.com/docs](https://supabase.com/docs)
- **Community**: [GitHub Discussions](https://github.com/supabase/supabase/discussions)
- **Issues**: [GitHub Issues](https://github.com/supabase/supabase-js/issues)
- **Discord**: [Supabase Discord](https://discord.supabase.com)
---
<div align="center">
**[Website](https://supabase.com) • [Documentation](https://supabase.com/docs) • [Community](https://github.com/supabase/supabase/discussions) • [Twitter](https://twitter.com/supabase)**
</div>