Supabase.js 1.0

Summary

Supabase has launched Supabase.js 1.0, updating its client library ecosystem with breaking API changes, scalability enhancements, and new documentation tooling. The release introduces native TypeScript implementations across all underlying sub-libraries, including supabase-js, postgrest-js, gotrue-js, and realtime-js, which also enables auto-generated reference docs. In response to community feedback, database and authentication operations now return structured error objects alongside data payloads instead of throwing runtime exceptions. Realtime client scalability is improved by consolidating multiple active subscriptions into a single socket connection per Supabase client. Additionally, the release updates authentication workflows via the newly created gotrue-js library to support third-party logins and OAuth providers alongside revised method names.

Context

Community feedback and the requirement to coordinate multiple underlying open-source sub-libraries motivated structural, ergonomic, and performance updates across the Supabase JavaScript library.

Approach / What changed

Supabase released version 1.0 of supabase-js, rewriting all sub-libraries natively in TypeScript, switching error handling from throwing exceptions to returning error objects, reducing realtime socket overhead to one connection per client, and adding gotrue-js for authentication.

Takeaways

• Supabase.js 1.0 shifts error handling from throwing runtime exceptions to returning error objects alongside data, allowing inline error evaluation.
• Realtime connection scalability is improved by sharing a single socket connection per Supabase client across all subscriptions rather than opening a connection per subscription.
• All core sub-libraries—supabase-js, postgrest-js, gotrue-js, and realtime-js—are natively written in TypeScript, facilitating auto-generated reference documentation.

Related reading

• Supabase · Sep 28, 2021

  Supabase Hacktoberfest Hackathon 2021

  Supabase announced its virtual open-source hackathon tied to Hacktoberfest 2021, running from October 1st to October 10th. Participants can compete individually or in teams of up to five to build a new open-source project with Supabase or contribute to designated community repositories. Submissions may use any programming language or framework but must be created during the event and made open source with a public code repository. Entries are evaluated on criteria including technical complexity, visual polish, functionality, and Supabase feature adoption across five award categories. Winners and runners-up receive limited edition Supabase swag, while participants retain full intellectual property rights over their submissions.

  Thor Schaeff

• Supabase · May 5, 2021

  Supabase Beta April 2021

  Supabase focused on platform stability, security enhancements, and community support during its April 2021 beta update cycle. To address visual accessibility needs for developers with astigmatisms or those operating in brightly lit environments, the team delivered Light Mode within the dashboard settings. The release also introduced OpenAPI-powered Storage API documentation, community translations for the main repository spanning nineteen distinct languages, and an experimental synchronization server connecting Postgres with Stripe. Dashboard components are systematically migrating into an open-source UI library, establishing necessary foundations for local development tooling and self-hosted environments. Additionally, the team reported substantial contributor growth across its realtime server and UI repositories while continuing engineering on a Workflows engine aimed at a July release.