This repository is an npm workspace that publishes the client-side packages for Seamless Auth:
| Package | What it is |
|---|---|
@seamless-auth/client |
Framework-agnostic core: the headless auth client, session store, result and error types. |
@seamless-auth/react |
React binding: AuthProvider, hooks, and optional prebuilt auth screens. Depends on the client package. |
@seamless-auth/react-native |
Headless React Native binding: provider, hooks, and the native ports for passkeys, keystore token storage, and in-app browser OAuth. |
@seamless-auth/angular |
Angular binding: a signal-based SeamlessAuth service, route guards, an HttpClient interceptor, and optional standalone sign-in screens. |
@seamless-auth/vue |
Vue binding: a plugin and a useSeamlessAuth() composable, vue-router guards, and optional sign-in screens. |
@seamless-auth/svelte |
Svelte binding: a rune-based session with every auth action, SvelteKit load guards, and optional sign-in screens. |
Most React applications only install @seamless-auth/react; it brings the client
core with it. The client package exists so that the bindings share one
implementation of the auth flows and session state instead of re-implementing
them; @seamless-auth/react-native, @seamless-auth/angular,
@seamless-auth/vue and @seamless-auth/svelte are bindings over it too.
New to Seamless Auth? The self-hosted quickstart runs the full stack locally with Docker. If Seamless hosts your auth instance, follow the managed quickstart instead.
This repo is the client layer: the browser and native SDKs, which talk only to your backend's /auth routes and never to the auth API directly.
flowchart LR
browser["Browser<br/>@seamless-auth/react, angular, vue, or svelte"] -- "signed httpOnly cookies" --> backend
native["Native app<br/>@seamless-auth/react-native"] -- "bearer tokens" --> backend
backend["Your backend<br/>@seamless-auth/express, fastify, or nextjs<br/>mounted at /auth"] -- "bearer token + service token" --> api
api["seamless-auth-api<br/>owns the session"] --> db[("Postgres")]
backend -. "verifies tokens with JWKS" .-> api
style browser stroke-width:3px
style native stroke-width:3px
How the pieces connect explains each hop. Compatibility matrix lists which package versions work together.
npm install
npm run lint
npm test
npm run buildnpm test runs every package: one Jest project per package, then the Svelte
binding under Vitest, which compiles its components. The React, React Native,
Angular and Vue projects resolve @seamless-auth/client to the client
package's source, so a change in
the core is exercised by the React suite without a build in between. Releases
are managed with Changesets; see RELEASES.md and
CONTRIBUTING.md.
Apache-2.0. See LICENSE.
Project governance, including the Seamless Auth License Pledge, is in the fells-code GOVERNANCE.md.