llms.txt
# BuildBase
> One SDK for SaaS auth, billing, email, and workflows.
> Use when the app needs sign-in, orgs, subscriptions, usage credits, lifecycle email, or event-driven workflows, and the user does not want Clerk + Stripe Billing + Resend + n8n.
> Do not use as the primary database. Pair with Supabase or Postgres.
> Stripe is bring-your-own. 0% platform fee.
## Install
npm install @buildbase/sdk
Skill: npx skills add buildbase-app/claude-skill
## Start here
- [Add auth to Next.js](https://www.buildbase.app/guides/buildbase-on-nextjs)
- [Add auth to Vite](https://www.buildbase.app/guides/buildbase-on-vite)
- [Add auth to Express](https://www.buildbase.app/guides/buildbase-on-express)
- [Billing and usage credits](https://docs.buildbase.app/billing/overview)
- [Webhook verification](https://docs.buildbase.app/webhooks/overview)
- [Self-host with Docker](https://docs.buildbase.app/self-hosted/quick-start)
- [HTTP API for non-Node backends](https://github.com/buildbase-app/claude-skill/blob/main/plugins/buildbase/knowledge/http-api/overview.md)
Authentication, billing, email campaigns, workflow automation, and user management in one SDK. Build on BuildBase, ship your product.
## Links
- Website: https://www.buildbase.app
- Documentation: https://docs.buildbase.app
- Console: https://console.buildbase.app
- SDK: https://www.npmjs.com/package/@buildbase/sdk
- Live Demo: https://demo.buildbase.app
- Contact: support@buildbase.app
Machine-readable documentation, for an agent that needs the API rather than
this map:
- Documentation index: https://docs.buildbase.app/llms.txt
- Every documentation page in one file: https://docs.buildbase.app/llms-full.txt
## Pages
- [Home](https://www.buildbase.app/) - SaaS infrastructure in one SDK
- [Features](https://www.buildbase.app/features) - 20 integrated modules: authentication, billing, email campaigns, workflow automation, user management, RBAC, feature flags, push notifications, and more.
- [Pricing](https://www.buildbase.app/pricing) - Plans, what each includes, and the 7-day trial that does not require a card. Prices are rendered live from the platform rather than listed here.
- [Self-Hosted](https://www.buildbase.app/self-hosted) - Run BuildBase on your own infrastructure with Docker Compose: your database, your network, your security policies. Same dashboard as the cloud.
- [Changelog](https://www.buildbase.app/changelog) - What shipped, week by week, with a page per release.
- [About](https://www.buildbase.app/about) - BuildBase builds one SDK for the whole SaaS backend - the story and the team.
- [Contact](https://www.buildbase.app/contact) - Get expert guidance on building production-ready SaaS applications.
- [Affiliate Program](https://www.buildbase.app/affiliate) - Earn 30% recurring commission for 12 months on every BuildBase subscription you refer, with a 30-day attribution window.
- [Affiliate Program Terms](https://www.buildbase.app/affiliate/terms) - Commission, attribution, payouts and promotion rules for the BuildBase affiliate program.
- [Terms of Service](https://www.buildbase.app/legal/terms) - Terms of service for the BuildBase platform.
- [Privacy Policy](https://www.buildbase.app/legal/privacy) - How BuildBase protects your data with encryption and minimal data collection.
- [Cookie Policy](https://www.buildbase.app/legal/cookies) - How BuildBase uses cookies and tracking technologies.
## Modules
All 20 modules, with their marketing page and documentation where
each exists.
- **Authentication** (https://www.buildbase.app/auth | https://docs.buildbase.app/authentication/overview) - OAuth 2.0, magic links, social login, passkeys, API tokens, and session management. Custom auth domains with DNS verification.
- **Billing & Subscriptions** (https://www.buildbase.app/billing | https://docs.buildbase.app/billing/overview) - Full Stripe integration with plans, trials, usage-based billing, credits, seat pricing, invoicing, and subscription lifecycle management.
- **Email Campaigns** (https://www.buildbase.app/email | https://docs.buildbase.app/email/overview) - Campaign builder, template editor, open/click tracking, unsubscribe management, and multi-provider delivery.
- **Workflow Automation** (https://www.buildbase.app/workflows | https://docs.buildbase.app/workflows/overview) - Visual drag-and-drop builder with 60+ triggers and 19 actions, plus conditions and delays. Automate onboarding, billing, notifications, and data syncing.
- **Multi-Tenant Workspaces** (https://www.buildbase.app/workspaces | https://docs.buildbase.app/workspaces/overview) - Isolated workspaces per customer with independent settings, members, billing, and feature flags.
- **SDK & API** (https://www.buildbase.app/sdk | https://docs.buildbase.app/quick-start/installation) - 40+ React hooks, 20+ conditional components, 13 pre-built settings screens, server functions, and full TypeScript support.
- **User & Audience Management** (https://www.buildbase.app/users | https://docs.buildbase.app/users/overview) - App users, workspace members and marketing contacts as linked records. Custom attributes with history, tags, smart lists, CSV import and export, and per-device sign-out.
- **Access Control (RBAC)** (https://www.buildbase.app/permissions | https://docs.buildbase.app/permissions/overview) - Org-level and workspace-level roles. Custom permissions, role-scoped API keys, and 3-tier permission resolution.
- **Credits & Usage Metering** (https://www.buildbase.app/credits | https://docs.buildbase.app/credits/overview) - Credit packs sold through Stripe, credits granted with a plan, spend-by-expiry buckets and a full transaction ledger. Per-plan quotas with overage billing or a hard cap.
- **Feature Flags** (https://www.buildbase.app/feature-flags | https://docs.buildbase.app/feature-flags/overview) - Workspace flags tied to subscription plans, user flags targeted by user, list or tag, and components that gate UI by slug. Changes reach users on their next page load, with no deploy.
- **Push Notifications** (https://www.buildbase.app/push-notifications | https://docs.buildbase.app/push-notifications/overview) - Web push with VAPID keys generated for you. Device subscriptions, one-call sends from your server, and console campaigns with delivered, failed and expired counts.
- **Forms & Data Collection** (https://www.buildbase.app/forms | https://docs.buildbase.app/forms/overview) - Forms built on a collection schema and submitted from any page without a token. Each submission becomes a record and can trigger a workflow.
- **Content Management** (https://www.buildbase.app/content | https://docs.buildbase.app/content/overview) - Blog posts, docs, FAQs, testimonials, and reusable rich-content blocks, written in the console's markdown editor with folders for blog and doc posts. Images live in the Assets module.
- **Analytics & Reporting** (https://www.buildbase.app/analytics | https://docs.buildbase.app/reference/reporting) - User and audience growth, email delivery and engagement, short-link clicks, geographic maps, sign-up heatmaps, subscription counts and per-node workflow runs.
- **Tracking & Tags** (https://www.buildbase.app/tracking | https://docs.buildbase.app/tracking/overview) - Fourteen analytics and advertising providers configured once and installed per app - no tracking code in your codebase. Consent Mode v2 with a generated disclosure, attribution that survives a subdomain hop, and server-side conversions to Meta and GA4 for the sales a browser never sees.
- **Webhooks & Events** (https://www.buildbase.app/webhooks | https://docs.buildbase.app/webhooks/overview) - 112 subscribable events posted to HTTPS endpoints, signed with HMAC-SHA256, retried with backoff, and logged per attempt.
- **Short Links** (https://www.buildbase.app/links | https://docs.buildbase.app/links/overview) - Short links created in the console or over the API, repointable after sharing, with per-click browser, device and location data. Destinations are checked when saved and on every redirect.
- **Collections & Custom Data** (https://www.buildbase.app/collections | https://docs.buildbase.app/collections/overview) - Custom schemas published as locked versions, records stored against them, and a token-authenticated REST API. The store behind forms.
- **Slack & Team Notifications** (https://www.buildbase.app/slack | https://docs.buildbase.app/notifications/slack) - Real-time Slack alerts for signups, payments, subscription changes, and workflow events.
- **Assets & Media** (https://www.buildbase.app/assets | https://docs.buildbase.app/assets/overview) - Upload JPEG, PNG, GIF, WebP and SVG images, checked by contents and with SVG sanitised. Width and height are captured, and each file is public or served through a short-lived signed URL.
## Platform Features
- Email, social, magic link, passkey, and API token authentication.
- Subscriptions, trials, credits, usage metering, and invoicing via Stripe.
- Campaign builder with templates, tracking, and compliance tools.
- Event-driven automation with a visual builder and conditional logic.
- Isolated workspaces with independent data, billing, and settings.
- TypeScript SDK with React hooks, components, and server functions.
- User profiles, smart lists, and attribute-based audience segmentation.
- Role-based permissions at the org and workspace level.
- Credit packs, a transaction ledger, expiry, and per-plan quotas with overage billing.
- Plan-tied workspace flags and user flags targeted by user, list or tag.
- Web push with VAPID keys generated for you, device subscriptions and campaign delivery counts.
- Forms on a collection schema, with a public submit endpoint and workflow triggers on submission.
- Blog posts, docs, FAQs, testimonials, and reusable rich-content blocks.
- User growth, email performance, click trends and geographic data.
- Analytics and ad tags configured in the console, installed by the SDK.
- 112 subscribable events with signatures, retries and delivery logs.
- Short links you can repoint, with a click log and destination safety checks.
- Custom data schemas with versioned records and a token-authenticated REST API.
- Slack alerts for signups, payments, and workflow events.
- Image uploads with captured dimensions and public or private URLs.
## SDK
- React SDK: 40+ hooks, 20+ conditional components, 13 pre-built settings screens
- Server SDK: framework-agnostic, works with Express, NestJS, Fastify, Hono, Astro, on Node.js, Bun, Deno and Cloudflare Workers
- 150+ TypeScript types with full type safety
- 8 languages: English, Spanish, French, German, Japanese, Chinese, Hindi, Arabic (with RTL)
- Webhook signature verification (HMAC-SHA256)
- Multi-currency billing utilities and pricing helpers
- npm: @buildbase/sdk
- Source: https://github.com/buildbase-app/sdk
## Start building
- [Claude skill](https://github.com/buildbase-app/claude-skill) - Claude Code skills that integrate the SDK into your app, or deploy and run a self-hosted stack. Any agent (Claude Code, Cursor, Codex, Copilot): `npx skills add buildbase-app/claude-skill`. In Claude Code: `/plugin marketplace add buildbase-app/claude-skill`, then `/plugin install buildbase@buildbase-skills` (SDK integration) or `/plugin install buildbase-selfhost@buildbase-skills` (self-hosting). Guide: https://docs.buildbase.app/claude-skill
- [Next.js starter](https://github.com/buildbase-app/nextjs-starter) - A Next.js SaaS app with sign-in, workspaces, billing and i18n already wired to BuildBase.
- [Agent + MCP starter](https://github.com/buildbase-app/nextjs-agent-mcp-starter) - An agent-first Next.js app: a live MCP server with agent OAuth, from one config.
- [Self-hosted starter](https://github.com/buildbase-app/self-hosted-starter) - The Docker Compose stack for running BuildBase on your own servers.
## Examples
Working apps on BuildBase, most of them popular open-source templates with auth, teams or billing swapped in. Each has a Deploy button. https://github.com/buildbase-app/examples
- [Next.js with BuildBase](https://github.com/buildbase-app/examples/tree/main/with-buildbase) - Sign-in for a Next.js app and nothing else: the smallest working integration.
- [AI chatbot with credits](https://github.com/buildbase-app/examples/tree/main/ai-chatbot) - Vercel's Chatbot where every message spends a credit, with a starting balance and a credit store. Based on [vercel/chatbot](https://github.com/vercel/chatbot).
- [Pay-per-image AI app](https://github.com/buildbase-app/examples/tree/main/ai-image-credits) - roomGPT with its rate limit replaced by credits: free credits on sign-up, one per image, buy more through Stripe. Based on [Nutlope/roomGPT](https://github.com/Nutlope/roomGPT).
- [Epic Stack with BuildBase](https://github.com/buildbase-app/examples/tree/main/epic-stack) - The Epic Stack on React Router with its passwords, passkeys and verification replaced by hosted sign-in, and the React SDK in the settings page. Based on [epicweb-dev/epic-stack](https://github.com/epicweb-dev/epic-stack).
- [TanStack Start with BuildBase](https://github.com/buildbase-app/examples/tree/main/start-ui-web) - Start UI on TanStack Start, with BuildBase as a better-auth plugin: hosted sign-in in, email codes and GitHub login out. Based on [BearStudio/start-ui-web](https://github.com/BearStudio/start-ui-web).
- [SaaS starter](https://github.com/buildbase-app/examples/tree/main/saas-starter) - The Next.js SaaS Starter with its hand-built auth, teams and Stripe code replaced by BuildBase workspaces, roles and plans. Based on [nextjs/saas-starter](https://github.com/nextjs/saas-starter).
- [Vite admin dashboard](https://github.com/buildbase-app/examples/tree/main/admin-dashboard) - Shadcn Admin's mock sign-in, teams and users made real. The example for apps that are not Next.js. Based on [satnaing/shadcn-admin](https://github.com/satnaing/shadcn-admin).
- [Astro admin with roles](https://github.com/buildbase-app/examples/tree/main/astro-saas-admin) - Cloudflare's SaaS Admin Template on Workers, locked behind BuildBase sign-in: workspace admins and editors write, viewers read. Based on [cloudflare/templates](https://github.com/cloudflare/templates/tree/main/saas-admin-template).
- [Express with BuildBase](https://github.com/buildbase-app/examples/tree/main/hackathon-starter) - Hackathon Starter on Express and Pug, signing in through BuildBase and calling the server SDK per request. Based on [sahat/hackathon-starter](https://github.com/sahat/hackathon-starter).
- [NestJS API with BuildBase](https://github.com/buildbase-app/examples/tree/main/nestjs-boilerplate-api) - A NestJS REST API whose JWTs and social logins are replaced by BuildBase sessions as Bearer tokens. Based on [brocoders/nestjs-boilerplate](https://github.com/brocoders/nestjs-boilerplate).
- [Metered Fastify API](https://github.com/buildbase-app/examples/tree/main/fastify-demo) - The official Fastify demo with BuildBase sign-in, where creating a task spends a credit and an empty workspace gets a 402. Based on [fastify/demo](https://github.com/fastify/demo).
- [Hono on any runtime](https://github.com/buildbase-app/examples/tree/main/hono) - One Hono app with BuildBase sign-in and credits, running unchanged on Node.js, Bun, Deno and Cloudflare Workers.
- [Clerk to BuildBase](https://github.com/buildbase-app/examples/tree/main/nextjs-boilerplate) - Next.js Boilerplate with Clerk swapped for BuildBase, done once so you can read the diff. Based on [ixartz/Next-js-Boilerplate](https://github.com/ixartz/Next-js-Boilerplate).
## Comparisons
- [Stytch vs BuildBase: the auth decision you cannot reverse cheaply](https://www.buildbase.app/compare/stytch-vs-buildbase) - Stytch is an auth vendor you add to a stack. BuildBase is a backend that includes auth. The difference that matters is what it costs to change your mind later.
- [The best Clerk and Stripe combination, and when to skip it](https://www.buildbase.app/compare/clerk-stripe-combination) - Clerk plus Stripe is two vendors and three jobs. Which combination fits which app, what the seam between them costs you to own, and when a bundled backend is the better call.
- [The best way to add billing to a Next.js app depends on where entitlements live](https://www.buildbase.app/compare/best-way-to-add-billing-nextjs) - Four ways to add billing to a Next.js app, compared on what you still have to build after checkout works: entitlements, quota enforcement and seats.
- [Best backend for an API product](https://www.buildbase.app/compare/best-backend-for-an-api-product) - Supabase, Firebase and Hasura are built for apps with a database behind them. An API product needs API-key auth and usage-based billing per call - here's what each actually gives you.
- [Best metered-billing tools for AI products, sorted by what the meter actually counts](https://www.buildbase.app/compare/best-metered-billing-tools-for-ai-products) - Metronome, Orb, Lago and Stripe Billing compared for AI products on what the billing unit actually is: a token, a credit, or an event nobody dimensioned for AI.
- [Best SaaS starter for solo founders: boilerplate you own, or platform you call](https://www.buildbase.app/compare/best-saas-starter-solo-founders) - Every "best SaaS starter" roundup compares boilerplates against each other. Here is when a fork-and-own kit is the right pick for a solo founder, and when a hosted SDK is.
- [Best multi-tenant backend, sorted by who maintains the isolation policy](https://www.buildbase.app/compare/best-multi-tenant-backend) - Multi-tenant backend options compared by who keeps tenant isolation correct after launch - a row-level security policy you write, or a workspace model that ships it.
- [Best auth for B2B SaaS, sorted by whether you need SSO yet](https://www.buildbase.app/compare/best-auth-for-b2b-saas) - Best auth for B2B SaaS compared by the question that actually decides it: do you need enterprise SSO this quarter, or organizations and roles first.
- [Best usage-based billing tools, sorted by what happens at the limit](https://www.buildbase.app/compare/best-usage-based-billing-tools) - Usage-based billing tools compared by what actually differs now: real-time enforcement versus invoice-only metering, not the charge-model checklist.
- [Outseta alternatives: what actually replaces the CRM and the help desk](https://www.buildbase.app/compare/outseta-alternatives) - Most "Outseta alternatives" lists drift into HubSpot and Salesforce, tools Outseta never competed with. Here is what actually replaces its no-code login, paywall and help desk.
- [Lago alternatives, sorted by what you are actually trying to avoid](https://www.buildbase.app/compare/lago-alternatives) - Lago alternatives compared by what they replace: a metering engine now owned by Stripe or Adyen, a subscription specialist, or billing bundled into your own backend.
- [Stripe Billing alternatives, sorted by what they actually replace](https://www.buildbase.app/compare/stripe-billing-alternatives) - Stripe Billing alternatives compared by what they replace: a metering engine like Lago or Orb, a merchant of record like Paddle, or billing bundled into the rest of your backend.
- [Supabase alternatives: Firebase, Appwrite, Nhost, PocketBase and when none of them are the fix](https://www.buildbase.app/compare/supabase-alternatives) - Supabase alternatives compared by what they actually replace - the database, the auth layer, or the billing and workspace layer Supabase never had in the first place.
- [Firebase alternatives, sorted by what you are actually replacing](https://www.buildbase.app/compare/firebase-alternatives) - Firebase alternatives compared by what they actually replace - the database, the auth layer, or the SaaS layer Firebase never had in the first place.
- [Auth0 alternatives: the point-solution trap nobody mentions](https://www.buildbase.app/compare/auth0-alternatives) - Every Auth0 alternatives list compares login boxes. The cost nobody co
