Migrate from 1.6 to 1.7

Find imports that need changes

Search your application and any internal packages:

rg '"@better-auth-ui/(core|react|solid)/plugins"' .
rg '"@better-auth-ui/(react|solid)/server"' .

Also search for APIs that moved or changed names:

rg '\b(AuthClient|createAuthClient|sessionOptions|ensureSession|prefetchSession|fetchSession)\b' .

Ignore generated output and dependency folders in the results.

Replace core plugin aggregate imports

The @better-auth-ui/core/plugins entry point no longer exists. Import each API from its plugin entry point.

import {
  type OrganizationLocalization,
  organizationPlugin,
  organizationQueryKeys
} from "@better-auth-ui/core/plugins"

import {
  type OrganizationLocalization,
  organizationPlugin,
  organizationQueryKeys
} from "@better-auth-ui/core/plugins/organization"

Use the plugin name at the end of the path. For example, use /plugins/api-key, /plugins/passkey, /plugins/two-factor, or /plugins/organization.

If one import contains APIs from different plugins, split it into one import for each plugin.

Move plugin hooks out of the framework root

Shared hooks remain in @better-auth-ui/react and @better-auth-ui/solid. Plugin hooks now use a plugin entry point.

import {
  useActiveOrganization,
  useInviteMember,
  useListOrganizations,
  useSession
} from "@better-auth-ui/react"

import { useSession } from "@better-auth-ui/react"
import {
  useActiveOrganization,
  useInviteMember,
  useListOrganizations
} from "@better-auth-ui/react/plugins/organization"

Use the same pattern with @better-auth-ui/solid/plugins/<plugin> in a Solid application.

Move option factories and auth client types to core

Version 1.7 makes query and mutation option factories framework-independent. Import shared factories and types from @better-auth-ui/core.

import {
  type AuthClient,
  sessionOptions,
  signOutOptions
} from "@better-auth-ui/react"

import {
  type AuthClient,
  sessionOptions,
  signOutOptions
} from "@better-auth-ui/core"

Import plugin factories and client types from the matching core plugin path:

import {
  type OrganizationAuthClient,
  inviteMemberOptions,
  listOrganizationsOptions
} from "@better-auth-ui/core/plugins/organization"

Keep framework hooks in the React or Solid package. For example, useSession remains in the framework root, and useListOrganizations moves to the framework organization entry point.

Move server helpers and rename session helpers

The React and Solid /server entry points no longer exist. Import shared server APIs from @better-auth-ui/core/server.

The session helper names now use a Server suffix:

import {
  ensureSession,
  sessionOptions
} from "@better-auth-ui/react/server"

import {
  ensureSessionServer,
  sessionOptionsServer
} from "@better-auth-ui/core/server"

Plugin server APIs use a plugin-specific core path. Their existing function names remain unchanged.

import {
  ensureActiveOrganization,
  listOrganizationsOptions
} from "@better-auth-ui/react/server"

import {
  ensureActiveOrganization,
  listOrganizationsOptions
} from "@better-auth-ui/core/plugins/organization/server"

Version 1.7 provides server entry points for API key, magic link, multi-session, organization, passkey, and username.

Update Solid auth client imports

If a Solid source file imports createAuthClient from Better Auth UI, import it from Better Auth instead.

import { createAuthClient } from "@better-auth-ui/solid"

import { createAuthClient } from "better-auth/solid"

Refresh copied components

If you installed shadcn/ui components, the source files are part of your application. A package update does not update those files.

Inspect the registry changes first:

bunx --bun shadcn@latest add @better-auth-ui/all --dry-run
bunx --bun shadcn@latest add @better-auth-ui/all --diff

Then refresh only the groups that your application uses. Merge the changes with your local customizations.

bunx --bun shadcn@latest add @better-auth-ui/auth @better-auth-ui/settings
bunx --bun shadcn@latest add @better-auth-ui/organization

@better-auth-ui/organization is a shadcn registry item. It is not an npm package.

If you use Zaidan, inspect the matching Solid registry entries before you replace local files:

bunx --bun shadcn@latest add https://better-auth-ui.com/r/solid/auth.json --dry-run
bunx --bun shadcn@latest add https://better-auth-ui.com/r/solid/organization.json --dry-run

Remove --dry-run after you review the changes. HeroUI components come from @better-auth-ui/heroui, so they do not need this copied-component step.