Installation

Install the package

npm

npm install @usebetterdev/tenant

pnpm

pnpm add @usebetterdev/tenant

yarn

yarn add @usebetterdev/tenant

bun

bun add @usebetterdev/tenant

The main package (@usebetterdev/tenant) includes the core library and all adapters via subpath exports. The CLI (@usebetterdev/tenant-cli) is used via npx for generating migrations and verifying your setup — no installation required.

Peer dependencies

You need a database driver and (optionally) a framework. Install the ones you use:

ORM adapter

Drizzle + pg

npm install drizzle-orm pg

Import: @usebetterdev/tenant/drizzle

Drizzle + postgres.js

npm install drizzle-orm postgres

Import: @usebetterdev/tenant/drizzle

Prisma

npm install @prisma/client @prisma/adapter-pg

Requires Prisma 7+ (@prisma/client >= 7.0.0 and @prisma/adapter-pg >= 7.0.0).

Import: @usebetterdev/tenant/prisma

Framework adapter

Hono

npm install hono

Import: @usebetterdev/tenant/hono

Express

npm install express

Requires Express 5+ (express >= 5.0.0).

Import: @usebetterdev/tenant/express

Next.js

Next.js is already installed in your project.

Import: @usebetterdev/tenant/next

Requirements

• Node.js 22+ (also supports Bun and Deno)
• PostgreSQL 13+ (RLS, session variables, SET LOCAL)
• TypeScript 5+ (recommended, but not required)
• Non-superuser database role for your application connection

Superusers bypass RLS

PostgreSQL superusers (like the default postgres user) bypass all Row-Level Security policies. Your application must connect as a regular (non-superuser) role for RLS to enforce tenant isolation. See Quick Start — Prerequisites for how to create one.

Subpath exports

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

Import	Contents
@usebetterdev/tenant	Core: betterTenant, getContext, runAs, runAsSystem
@usebetterdev/tenant/drizzle	drizzleDatabase, tenantsTable, tenantId
@usebetterdev/tenant/prisma	prismaDatabase
@usebetterdev/tenant/hono	createHonoMiddleware
@usebetterdev/tenant/express	createExpressMiddleware
@usebetterdev/tenant/next	withTenant

Next steps

• Quick Start — wire up a working multi-tenant app