Stable release ready for Better Auth

Test any user, any role.
One click.

Stop logging in and out to test roles and permissions. A development-only panel for Better Auth that spawns managed test users and switches sessions instantly, right inside your app.

Auth DevTools
dev

Current session

AD

admin@acme.test

role: admin

active

Test users

3

live preview · click a user to switch

Features

Everything you need to test auth

Built for the inner loop — the fast, repeatable checks you run dozens of times a day while building auth-gated features.

ADadmin@acme.test
EDeditor@acme.test
VIviewer@acme.test
QAqa@acme.test

Managed test users

Spin up test accounts from templates you define. Keep real users out of your everyday auth checks.

ED
AD

Instant session switching

Jump into any managed user in one click. The app reloads against the new Better Auth session.

{
  "user": {
    "role": "admin"
  }
}

Session inspection

Read the exact session your app exposes — user fields plus approved metadata.

roleeditor ▾

Field patching

Edit only the fields you explicitly allow, then refresh with the updated auth state.

Admin
Editor
Viewer

Repeatable personas

Stable roles like Admin, Editor, and Viewer make auth-gated UI easy to verify — every time.

development · on
production · off

Dev-only by design

On in development, off in production, with an explicit kill switch you control.

Install

Two integration points

One server plugin and one zero-prop React component. No client plugin, no server-to-client wiring.

1Add the plugin
auth.ts
import { betterAuth } from "better-auth";
import { devtools } from "better-auth-devtools";

export const auth = betterAuth({
  database,
  plugins: [devtools({ enabled: true })],
});
2Mount the panel
providers.tsx
"use client";

import { BetterAuthDevtools } from "better-auth-devtools/react";

export function DevtoolsWrapper() {
  return <BetterAuthDevtools />;
}

Explicitly enabled for development. Production stays disabled. After adding it, run npx auth@latest migrate to apply the schema.

Stop logging out to test as someone else

Install the package, add the plugin, and switch between managed test users in one click.