@supabase/gotrue-js

auth-js

An isomorphic JavaScript client library for the Supabase Auth API.

Docs

• Using auth-js: https://supabase.com/docs/reference/javascript/auth-signup
• TypeDoc: https://supabase.github.io/auth-js/v2

Quick start

Install

npm install --save @supabase/auth-js

Usage

import { AuthClient } from '@supabase/auth-js'

const GOTRUE_URL = 'http://localhost:9999'

const auth = new AuthClient({ url: GOTRUE_URL })

• signUp(): https://supabase.io/docs/reference/javascript/auth-signup
• signIn(): https://supabase.io/docs/reference/javascript/auth-signin
• signOut(): https://supabase.io/docs/reference/javascript/auth-signout

Custom fetch implementation

auth-js uses the cross-fetch library to make HTTP requests, but an alternative fetch implementation can be provided as an option. This is most useful in environments where cross-fetch is not compatible, for instance Cloudflare Workers:

import { AuthClient } from '@supabase/auth-js'

const AUTH_URL = 'http://localhost:9999'

const auth = new AuthClient({ url: AUTH_URL, fetch: fetch })

Sponsors

We are building the features of Firebase using enterprise-grade, open source products. We support existing communities wherever possible, and if the products don’t exist we build them and open source them ourselves.

Changelog

2.66.1 (2024-12-04)

Bug Fixes

• add loose auto complete to string literals where applicable (#966) (fd9248d)
• add new error codes (#979) (dfb40d2)
• don't remove session for identity linking errors (#987) (e68ebe6)