SaaS

Installs the shared base of a SaaS app as one block. Every starter preset lists saas instead of the eleven blocks behind it, and invitations comes with organizations.

better-supabase add saas

export default defineConfig({ blocks: { saas: {} } });

add lists saas in blocks, writes the modules of every part and wires the client in lib/blocks.ts. Import the manifest from better-supabase/blocks/saas when you build the set with createBlocks.

import { saasBlock } from "better-supabase/blocks/saas";

PartsCopy Anchor Link

Installing saas installs these blocks. Each stays an ordinary block in the config and keeps its own client.

• organizations
• teams
• profiles
• billing
• entitlements
• notifications
• audit
• api-keys
• settings
• onboarding
• outbox

HelpersCopy Anchor Link

inviteWithinSeats: Invite a member only while the plan has a seat left. It counts the members, asks entitlements for the seats left and sends the invitation. With no seat left it returns an invalid_request error and sends nothing.

await blocks.saas.inviteWithinSeats({
  organizationId,
  email: "ann@example.com",
  role: "member",
});

rotateApiKey: Rotate an API key and keep the old token working for graceHours more hours (24 by default, 0 to 720). It calls apiKeys.rotate, so the new token is returned once and only its hash is stored. A value outside the range returns an invalid_request error and rotates nothing.

const rotated = await blocks.saas.rotateApiKey({ id: keyId, graceHours: 48 });

An app that installs the key block without the other parts of saas builds just this helper with createKeyRotator({ apiKeys }) from better-supabase/blocks/saas. The Next.js example does, in apps/examples/nextjs/src/features/composites/composites.ts, and calls it from the rotateKey server action.

The helper returns a Result; each step is idempotent, so retrying after a partial failure is safe.

RemoveCopy Anchor Link

better-supabase remove saas
better-supabase remove saas --with-parts

The first command replaces saas in blocks with its parts. The second removes the parts too, except any part another block still needs (remove).