Getting started

Using React or Next.js?

Jump straight to the React quick start to scaffold hooks, forms, and modals with one command. This page walks through the framework-agnostic JavaScript SDK.

1. Create an app

Public key (sa_live_…) — safe to ship in browsers and mobile clients.
Secret key (sa_secret_…) — backend only. Never expose this in client code.

2. Install

Pick the starting point that matches your stack.

npm install @simpleauthjs/core

Continue with step 3 below.

npx @simpleauthjs/react init

The CLI installs @simpleauthjs/core and scaffolds a typed client, SimpleAuthProvider, hooks, and UI components into components/simpleauth/ — all files you own and can edit.

Head to the React quick start for the rest of the flow.

3. Initialize the client

import { createSimpleAuthClient } from "@simpleauthjs/core"

const auth = createSimpleAuthClient({
  apiKey: "sa_live_…",
})

await auth.register({
  email: "user@example.com",
  password: "s3cureP@ssword",
  name: "Jane Doe",
})

await auth.login({
  email: "user@example.com",
  password: "s3cureP@ssword",
})

const { user } = await auth.me()
console.log(user.email)