@simpleauthjs/react

SimpleAuth CLI for copying auth primitives (provider, client helper, hooks, forms, modals) into your React or Next.js codebase. You own every generated file under components/simpleauth/.

Documentation

The CLI reference, flags, presets, style variants, component APIs, hooks, and recipes are maintained in the main SimpleAuth documentation site:

React quick start (path on the docs host, for example https://your-docs.example.com/docs/react/quick-start).

Minimal commands

npx @simpleauthjs/react init
npx @simpleauthjs/react add sign-in
npx @simpleauthjs/react add sign-up --style modern

Use individual features (sign-up, modal, forgot-password, reset-password, verify-email, sign-out, delete-account, session) or presets:

• add basic — sign-in, sign-up, forgot-password, reset-password, verify-email
• add full — everything in basic, plus modal, sign-out, delete-account, session

The --style minimal|modern flag selects the plain-CSS look for generated forms and modals (where applicable).

add verify-email requires add sign-up first (it reuses the generated VerifyEmailPrompt component).

add session ships Show for declarative gates (signed-in, signed-out, email-verified) with an optional loading fallback, plus optional footer links on sign-in / sign-up / forgot-password / reset forms (signInHref, signUpHref, forgotPasswordHref, or matching onSwitchTo* callbacks) so users can move between flows.