# Buildspace Developer Documentation

> Build apps with authentication, events, storage, databases, and notifications — all managed from one platform.

## Getting Started

- [Buildspace SDK Documentation](/docs.md): Use one package for auth, billing, events, storage, and notifications.

## Agent-native

- [Build with an AI agent](/docs/agent-native.md): Zero-setup flow for AI coding agents. Authenticate with an env var, create a project non-interactively, and give your agent the full Buildspace context.

## Api-keys

- [API Keys](/docs/api-keys.md): When to use secret keys vs publishable keys.

## Faq

- [FAQ](/docs/faq.md): Common questions about how Buildspace works and why teams use it.

## Installation

- [Installation](/docs/installation.md): Install the Buildspace SDK or CLI depending on whether you are building in code or managing apps from the terminal.

## Quick-start-client

- [Quick Start (Client)](/docs/quick-start-client.md): Initialize the browser SDK with a publishable key.

## Quick-start-server

- [Quick Start (Server)](/docs/quick-start-server.md): Initialize the server SDK with a secret key.

## Api-reference

- [BuildspaceClient (Client)](/docs/api-reference/buildspace-client.md): Browser SDK client reference.
- [BuildspaceError](/docs/api-reference/buildspace-error.md): Unified SDK error type.
- [Buildspace (Server)](/docs/api-reference/buildspace-server.md): Server SDK class reference.
- [Configuration](/docs/api-reference/configuration.md): Shared configuration options for server and client SDK initialization.

## Authentication

- [Client SDK](/docs/auth/client-sdk.md): Browser-side auth URL generation methods.
- [Overview](/docs/auth/overview.md): Authentication concepts for Buildspace SDK integrations.
- [Server SDK](/docs/auth/server-sdk.md): Server-side authentication methods.
- [Sessions](/docs/auth/sessions.md): Validate, forward, and revoke Buildspace sessions.

## Billing

- [API Reference](/docs/billing/api-reference.md): Billing methods available in the Buildspace SDK.
- [Customer Portal](/docs/billing/customer-portal.md): Let paid users manage their subscription, payment method, and invoices through Stripe-hosted pages.
- [Entitlements](/docs/billing/entitlements.md): Gate paid features from Buildspace-synced billing state.
- [Overview](/docs/billing/overview.md): Add paid plans to a Buildspace app without embedding Stripe directly in app code.
- [Pricing Page](/docs/billing/pricing-page.md): Render plans from the Buildspace billing catalog and send the signed-in user to Checkout.
- [Setup](/docs/billing/setup.md): Connect Stripe in Studio and enable billing for a specific app environment.
- [Testing](/docs/billing/testing.md): Validate billing in development with Stripe test mode and Buildspace webhook processing.

## CLI

- [App Lifecycle](/docs/cli/app-lifecycle.md): Install the CLI, create a Buildspace app, clone it locally, and deploy it with the buildspace command.
- [App Management](/docs/cli/apps.md): Create, list, delete, and manage hosting for your Buildspace apps.
- [Authentication](/docs/cli/auth.md): Sign in and manage personal access tokens with the Buildspace CLI.
- [Configuration](/docs/cli/config.md): Configure CLI base URLs and settings.
- [Deploy](/docs/cli/deploy.md): Deploy your app and monitor deployment status with the Buildspace CLI.
- [Environment Variables](/docs/cli/env.md): Manage environment variables for your Buildspace apps.
- [Clone an App](/docs/cli/init.md): Use buildspace init to clone a managed Buildspace app repository and pull local environment variables.
- [JSON Output](/docs/cli/json-output.md): Use the --json flag for machine-readable CLI output.
- [CLI Overview](/docs/cli/overview.md): Install the Buildspace CLI, use the buildspace command, and manage your app lifecycle from the terminal.
- [Telemetry](/docs/cli/telemetry.md): Manage anonymous product telemetry in the BuildSpace CLI.

## Database

- [Overview](/docs/database/overview.md): Managed Turso databases for your Buildspace apps.
- [Schema & Queries](/docs/database/schema-and-queries.md): Define your database schema and run queries with Drizzle ORM.
- [Setup](/docs/database/setup.md): Connect your app to its Buildspace-managed Turso database.

## Events

- [Analytics](/docs/events/analytics.md): Query event volumes and behavior trends.
- [Client SDK](/docs/events/client-sdk.md): Browser-side events tracking methods.
- [Overview](/docs/events/overview.md): Track product activity with Buildspace Events.
- [Server SDK](/docs/events/server-sdk.md): Server-side events tracking methods.
- [Subscriptions](/docs/events/subscriptions.md): Subscribe workflows to event topics.

## Redis

- [Overview](/docs/redis/overview.md): Optional managed Redis add-on for your Buildspace apps.
- [Setup](/docs/redis/setup.md): Enable Redis and connect your app to it.

## Notifications

- [Overview](/docs/notifications/overview.md): Send transactional email with Buildspace Notifications.
- [Server SDK](/docs/notifications/server-sdk.md): Server-side notifications methods.
- [Templates](/docs/notifications/templates.md): Reuse stored templates with interpolation variables.
- [Triggers](/docs/notifications/triggers.md): Drive notification sends from application and event logic.
- [Webhooks](/docs/notifications/webhooks.md): Handle provider delivery status callbacks.

## Storage

- [Client SDK](/docs/storage/client-sdk.md): Browser-side storage methods.
- [Overview](/docs/storage/overview.md): Upload and retrieve files through Buildspace Storage.
- [Server SDK](/docs/storage/server-sdk.md): Server-side storage methods.

## Full Documentation

- [Complete Documentation](/llms-full.txt): All documentation merged into a single file