Introduction

better-supabase is one package that removes the glue code every Supabase app rewrites: auth wiring, typed repositories, pagination, includes, nested filters, soft delete, timestamps, upserts, cache invalidation, list pages, storage paths and realtime topics.

Built on SupabaseCopy Anchor Link

It is built directly on Supabase's own packages:

• @supabase/supabase-js for the per-request clients, Storage, Realtime and Edge Functions,
• @supabase/server for local token verification, auth modes and the env shape,
• @supabase/middleware for composable context (ctx.supabase, ctx.postgres),
• @supabase/ssr for cookie sessions,
• @supabase/postgrest-typegen for the database.types.ts the CLI writes, the same file supabase gen types writes.

Supabase packages lists every package, how it is installed and how it relates to the supabase CLI.

What you getCopy Anchor Link

• A CLI that generates stronger types. better-supabase gen wraps supabase gen types and adds what it leaves out: relationship cardinality, unique keys, CHECK-constraint unions, typed jsonb, column maps for camelCase apps and per-table flags.
• A typed repository. db.customers.findMany({ where, include, orderBy }) compiles to a single PostgREST request, or to SQL on the direct-Postgres path. Every call returns a Result; .orThrow() is opt-in.
• Auth glue that avoids network calls. Valid access tokens never touch the Auth server. Refresh happens once, in the proxy, and is single-flighted.
• Framework adapters. Next.js, Hono, oRPC, Supabase Edge Functions and a minimal MCP server.
• Frontend helpers. TanStack Query options derived from the query, with table-based invalidation and optimistic updates.
• Standards on request. Standard Schema, JSON Schema, OpenAPI, RFC 9457 problem details, OpenTelemetry, CloudEvents, Standard Webhooks and more.

Next stepsCopy Anchor Link