Quick Start
Getting started with Better Auth UI for Solid/Zaidan components.
Zaidan installs Solid-owned Better Auth UI component files into your app. Use this page for the happy path: prepare a TanStack Start app, install the composed auth registry entry, then add settings or user surfaces when you need them.
Use Solid for @better-auth-ui/solid package/runtime APIs.
Prerequisites
Before installing registry entries, make sure your app has:
- Better Auth
- TanStack Start for Solid
@better-auth-ui/solidand@tanstack/solid-query- Tailwind v4 and the local UI primitives copied by Solid/Zaidan components
Installation
Install the auth components
Install the composed auth route surface with the shadcn CLI from the Better Auth UI Solid registry.
npx shadcn@latest add https://better-auth-ui.com/r/solid/auth.jsonThis installs the <Auth /> component and its views: sign-in, sign-up, forgot-password, reset-password, and sign-out.
Install settings and user button (optional)
If you need the settings page and user button, install them separately.
npx shadcn@latest add https://better-auth-ui.com/r/solid/settings.json https://better-auth-ui.com/r/solid/user-button.jsonInstall plugin surfaces as needed
Plugin registry entries stay optional. Add them when your app enables the matching Better Auth plugin.
npx shadcn@latest add https://better-auth-ui.com/r/solid/passkey.jsonThe registry entries are generated from examples/start-solid-zaidan-example/registry.manifest.ts and hosted under apps/docs/public/r/solid/**.
The generated registry index is available at https://better-auth-ui.com/r/solid/registry.json.
Next Steps
Follow the framework setup first, then use the component and plugin pages as references while reviewing copied files.
TanStack Start
Prepare a Solid app for Solid/Zaidan components.
Additional Fields
Render custom Better Auth user fields in copied Solid forms.
Solid Reference
Every Zaidan registry entry is built on the shared @better-auth-ui/solid data layer. Dive into the Solid package APIs when you need to read, mutate, or extend auth state directly.
Zaidan boundary
- Installable auth, user, settings, and plugin component files.
- Zaidan/Tailwind/Kobalte setup needed by those registry entries.
- Links back to Solid runtime docs when an installed component needs package APIs.
- Social/GitHub provider buttons are included by auth registry entry when your Better Auth client enables those providers.
Last updated on