Introduction

BuildBase is SaaS infrastructure in one SDK. Authentication, billing, workspaces, permissions, email, workflow automation, tracking and more: 20 modules, integrated and production-ready.

SaaSOSProvider

Every BuildBase app starts with SaaSOSProvider - the root context provider that connects your React app to the BuildBase platform. "SaaS OS" stands for SaaS Operating System: the infrastructure layer your product runs on. Wrap your app once, and every hook and component in the SDK has access to your org, auth state, workspace, and permissions.

npm install @buildbase/sdk

import { ApiVersion } from '@buildbase/sdk';
import { SaaSOSProvider } from '@buildbase/sdk/react';

import '@buildbase/sdk/css';

export default function Providers({ children }) {
  return (
    <SaaSOSProvider
      serverUrl="https://api.console.buildbase.app"
      version={ApiVersion.V1}
      orgId="your-org-id"
      auth={{
        clientId: 'your-client-id',
        redirectUrl: 'http://localhost:3000/callback',
      }}
      locale="en"
    >
      {children}
    </SaaSOSProvider>
  );
}

import {
  useSaaSAuth,
  WhenAuthenticated,
  WhenUnauthenticated,
} from '@buildbase/sdk/react';

function App() {
  const { user, signIn, signOut } = useSaaSAuth();

  return (
    <>
      <WhenUnauthenticated>
        <button onClick={() => signIn()}>Sign In</button>
      </WhenUnauthenticated>
      <WhenAuthenticated>
        <p>Welcome, {user?.name}</p>
        <button onClick={signOut}>Sign Out</button>
      </WhenAuthenticated>
    </>
  );
}

What's included

20 modules, all in the same SDK and console:

Across every module, the SDK also ships:

Which docs do I need?

Most SaaS builders only need the SDK README on npm. It covers installation, all hooks, components, and pre-built UI - everything you need to ship.

These docs go deeper into patterns, composition, and server-side integration for teams with custom requirements.

Next Steps

• Installation - Install the SDK and configure the provider.
• Claude skill - Let Claude Code do the integration, or start from a starter repo.
• Quickstart - Build a working app with auth in 5 minutes.
• SDK README - Full API reference on npm.