Registry / web-framework / better-auth-studio

better-auth-studio

library1.1.3-beta.49jsnpmunverified

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.

web-framework auth-security database

npm install better-auth-studio

package ↗homepage ↗

INSTALL

IMPORT

SIG · BETTER-AUTH-STUDIO

better-auth-studio

web-frameworkjavascriptv1.1.3-beta.49

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

betterAuthStudio

✓ import betterAuthStudio from 'better-auth-studio'

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

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

start

✓ betterAuthStudio.start({ port: 3000 })

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

start returns a Promise; no callback parameter is accepted.

start

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

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

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

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

Debug

Known issues

breakingBetter 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.

affects: <2.0.0

deprecatedUsing '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.

affects: >=0.0.1

gotchaBetter 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.

affects: >=0.0.1

gotchaThe 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.

affects: >=0.0.1

gotchaWhen 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.

affects: >=0.0.1

gotchaThe 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.

affects: >=0.0.1

Errors

Common errors & fixes

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

Package not installed or not in node_modules.

fix

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

Error: Port 3000 is already in use

Another process is using the default port.

fix

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

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

Missing auth.ts or incorrect path.

fix

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

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

Unsupported or misconfigured database adapter.

fix

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

Upgrade

Version history

1.1.3-beta.49latest on npm

Audit

Dependencies

better-authrequiredThe studio is designed to manage Better Auth projects. It reads the auth configuration and interacts with Better Auth's database schema.

better-sqlite3optionalRequired only if using SQLite as the database. Better Auth Studio auto-detects the database from auth.ts.

@prisma/clientoptionalRequired only if using Prisma as the ORM for the database.

Agent activity

21 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://www.npmjs.com/package/better-auth-studio ↗

homepagehttps://better-auth.com ↗