{"id":18158,"library":"better-auth-studio","title":"Better Auth Studio","description":"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.","status":"active","version":"1.1.3-beta.49","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","admin","authentication","better-auth","dashboard","gui","studio","typescript"],"install":[{"cmd":"npm install better-auth-studio","lang":"bash","label":"npm"},{"cmd":"yarn add better-auth-studio","lang":"bash","label":"yarn"},{"cmd":"pnpm add better-auth-studio","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"The studio is designed to manage Better Auth projects. It reads the auth configuration and interacts with Better Auth's database schema.","package":"better-auth","optional":false},{"reason":"Required only if using SQLite as the database. Better Auth Studio auto-detects the database from auth.ts.","package":"better-sqlite3","optional":true},{"reason":"Required only if using Prisma as the ORM for the database.","package":"@prisma/client","optional":true}],"imports":[{"note":"ESM-only; CommonJS require is not supported. TypeScript types are included.","wrong":"const betterAuthStudio = require('better-auth-studio')","symbol":"betterAuthStudio","correct":"import betterAuthStudio from 'better-auth-studio'"},{"note":"start returns a Promise; no callback parameter is accepted.","wrong":"betterAuthStudio.start({ port: 3000 }, () => {})","symbol":"start","correct":"betterAuthStudio.start({ port: 3000 })"},{"note":"Named export from the main package, not a subpath export.","wrong":"import start from 'better-auth-studio/start'","symbol":"start","correct":"import { start } from 'better-auth-studio'"}],"quickstart":{"code":"cd your-better-auth-project\npnpm add -D better-auth-studio\npnpm better-auth-studio start","lang":"javascript","description":"Install the studio as a dev dependency and start the GUI dashboard. The studio auto-detects your auth config and database."},"warnings":[{"fix":"Pin to a specific version and check changelog before upgrading.","message":"Better Auth Studio is currently in beta and may have breaking changes between minor versions.","severity":"breaking","affected_versions":"<2.0.0"},{"fix":"Use 'pnpx better-auth-studio@<version>' or install as a dev dependency with an exact version.","message":"Using 'pnpx better-auth-studio' without specifying a version may install a newer beta with breaking changes.","severity":"deprecated","affected_versions":">=0.0.1"},{"fix":"Ensure auth.ts exists and exports a betterAuth instance.","message":"Better Auth Studio requires a valid auth.ts configuration file in the project root. If missing, the studio will fail to start.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Upgrade Node.js to v18+ or use a compatible runtime.","message":"The studio requires Node.js v18 or higher due to use of native fetch and other modern APIs.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Ensure @prisma/client and Prisma Client are up-to-date and generated.","message":"When using Prisma, the PrismaClient must be properly instantiated and accessible; otherwise database connection may fail.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Run Better Auth's database migrations before starting the studio.","message":"The studio may not work if the database schema is not up-to-date with Better Auth's expectations (e.g., missing tables).","severity":"gotcha","affected_versions":">=0.0.1"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run 'pnpm add -D better-auth-studio' in your project.","cause":"Package not installed or not in node_modules.","error":"Error: Cannot find module 'better-auth-studio'"},{"fix":"Start the studio on a different port: 'betterAuthStudio.start({ port: 3001 })'","cause":"Another process is using the default port.","error":"Error: Port 3000 is already in use"},{"fix":"Create an auth.ts file that exports a betterAuth instance in the project root.","cause":"Missing auth.ts or incorrect path.","error":"Error: No auth configuration found. Please ensure 'auth.ts' exists in your project root."},{"fix":"Ensure your auth.ts uses one of the supported adapters (prismaAdapter, drizzleAdapter, or better-sqlite3).","cause":"Unsupported or misconfigured database adapter.","error":"Error: Database adapter not detected. Supported adapters: Prisma, Drizzle, SQLite."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}