Installation

Install the package

npm

npm install @usebetterdev/console

pnpm

pnpm add @usebetterdev/console

yarn

yarn add @usebetterdev/console

bun

bun add @usebetterdev/console

The main package (@usebetterdev/console) includes the core library and all adapters via subpath exports. The CLI (@usebetterdev/console-cli) is used via npx — no installation required.

Peer dependencies

Hono (required)

UseBetter Console uses Hono middleware to intercept /.well-known/better/* requests:

npm install hono

Drizzle + pg (optional)

Only needed if you use the magic link authentication flow in production. Auto-approve mode is stateless and needs no database at all.

npm install drizzle-orm pg

Note

If you only use autoApprove (development mode), you don’t need Drizzle, pg, or any database tables. Auto-approve issues a stateless JWT immediately.

Requirements

• Node.js 22+ (also supports Bun and Deno)
• PostgreSQL 13+ (only needed for magic link auth — auto-approve needs no database)
• TypeScript 5+ (recommended, but not required)

Subpath exports

All adapters are available through the main package via subpath exports:

Import	Contents
@usebetterdev/console	Core: betterConsole, types, config
@usebetterdev/console/drizzle	drizzleConsoleAdapter, schema tables
@usebetterdev/console/hono	createConsoleMiddleware

Next steps

• Quick Start — connect your app to UseBetter Console in 5 minutes