Supabase-js is a JavaScript client library that provides isomorphic access to Supabase backend services from Node.js, browser, and edge runtime environments.
The library solves the problem of integrating with Supabase by bundling multiple specialized SDKs into a single package. It wraps PostgREST for database queries, a real-time subscriptions system for live data updates, authentication handling, file storage operations, and the ability to invoke Postgres functions and Supabase Edge Functions. The isomorphic design means the same code can run across different JavaScript environments without modification.
Developers should choose this library if they are building applications on top of Supabase infrastructure and want a unified client rather than managing separate packages. It suits projects ranging from simple CRUD applications to complex systems requiring real-time features and file handling. The library includes TypeScript support throughout, making it suitable for type-safe development. Projects using frameworks like Nuxt and Svelte have documented examples available.
The project maintains a clear support policy tied to official runtime schedules. It drops support for Node.js and Deno versions that reach end-of-life in minor releases without treating these as breaking changes, keeping the library aligned with actively maintained runtimes. The monorepo structure separates concerns into distinct packages for authentication, database operations, real-time subscriptions, storage, and edge functions, allowing developers to understand and depend on specific functionality independently.
