Quick Start
Getting started with Better Auth UI for Solid/Zaidan components.
Zaidan installs Better Auth UI components that your Solid application owns. This guide prepares TanStack Start and installs the authentication registry entry.
You can then add settings, user controls, and plugin components.
Use Solid for @better-auth-ui/solid package/runtime APIs.
Prerequisites
Before you install registry entries, add these prerequisites:
- 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 command installs <Auth /> and its built-in authentication views.
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 everything (optional)
Install all Solid/Zaidan components, plugin surfaces, and email templates with one command.
npx shadcn@latest add https://better-auth-ui.com/r/solid/all.jsonInstall plugin surfaces as needed
Plugin registry entries are optional. If the application enables a Better Auth plugin, add its matching registry entry.
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
Complete the framework setup first. Then use the component and plugin pages while you review the 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
Each Zaidan registry entry uses the shared @better-auth-ui/solid data layer. Read the Solid reference to access or change authentication state directly.
What Zaidan includes
- 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