Better Auth Studio

1.1.3-beta.49 verified Sat Apr 25 auth: no javascript

Better Auth Studio v1.1.3-beta.49 is a web-based GUI dashboard for managing Better Auth applications (authentication framework). It provides a comprehensive admin interface for users, organizations, teams, and more. Features include user CRUD, role management, bulk seeding, and analytics. Currently in early beta, it works with Prisma, Drizzle, SQLite, PostgreSQL, and MySQL. Requires Node >= 18 and a Better Auth project with a valid auth.ts config. Compared to generic database admin UIs, it's purpose-built for Better Auth and automatically detects adapter configurations.

Common errors

error Error: Cannot find module 'better-auth-studio' ↓

cause Package not installed or not in node_modules.

fix

Run 'pnpm add -D better-auth-studio' in your project.

error Error: Port 3000 is already in use ↓

cause Another process is using the default port.

fix

Start the studio on a different port: 'betterAuthStudio.start({ port: 3001 })'

error Error: No auth configuration found. Please ensure 'auth.ts' exists in your project root. ↓

cause Missing auth.ts or incorrect path.

fix

Create an auth.ts file that exports a betterAuth instance in the project root.

error Error: Database adapter not detected. Supported adapters: Prisma, Drizzle, SQLite. ↓

cause Unsupported or misconfigured database adapter.

fix

Ensure your auth.ts uses one of the supported adapters (prismaAdapter, drizzleAdapter, or better-sqlite3).

Warnings

breaking Better Auth Studio is currently in beta and may have breaking changes between minor versions. ↓

fix Pin to a specific version and check changelog before upgrading.

deprecated Using 'pnpx better-auth-studio' without specifying a version may install a newer beta with breaking changes. ↓

fix Use 'pnpx better-auth-studio@<version>' or install as a dev dependency with an exact version.

gotcha Better Auth Studio requires a valid auth.ts configuration file in the project root. If missing, the studio will fail to start. ↓

fix Ensure auth.ts exists and exports a betterAuth instance.

gotcha The studio requires Node.js v18 or higher due to use of native fetch and other modern APIs. ↓

fix Upgrade Node.js to v18+ or use a compatible runtime.

gotcha When using Prisma, the PrismaClient must be properly instantiated and accessible; otherwise database connection may fail. ↓

fix Ensure @prisma/client and Prisma Client are up-to-date and generated.

gotcha The studio may not work if the database schema is not up-to-date with Better Auth's expectations (e.g., missing tables). ↓

fix Run Better Auth's database migrations before starting the studio.

Install

npm install better-auth-studio

yarn add better-auth-studio

pnpm add better-auth-studio

Imports

betterAuthStudio

wrong

const betterAuthStudio = require('better-auth-studio')

correct

import betterAuthStudio from 'better-auth-studio'

ESM-only; CommonJS require is not supported. TypeScript types are included.

start

wrong

betterAuthStudio.start({ port: 3000 }, () => {})

correct

betterAuthStudio.start({ port: 3000 })

start returns a Promise; no callback parameter is accepted.

start

wrong

import start from 'better-auth-studio/start'

correct

import { start } from 'better-auth-studio'

Named export from the main package, not a subpath export.

Quickstart

Install the studio as a dev dependency and start the GUI dashboard. The studio auto-detects your auth config and database.

cd your-better-auth-project
pnpm add -D better-auth-studio
pnpm better-auth-studio start