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

npm install drizzle-orm pg

Import: @usebetterdev/tenant/drizzle

Prisma

npm install @prisma/client

Import: @usebetterdev/tenant/prisma

Framework adapter

Hono

npm install hono

Import: @usebetterdev/tenant/hono

Express

npm install express

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)

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	drizzleAdapter, createGetTenantRepository
@usebetterdev/tenant/prisma	prismaAdapter, createGetTenantRepository
@usebetterdev/tenant/hono	createHonoMiddleware
@usebetterdev/tenant/express	createExpressMiddleware
@usebetterdev/tenant/next	withTenant

Next steps

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