# Capsule

## Docs

- [Add Data And State](https://docs.capsule.new/build/add-data-and-state.md): Use session data for conversation state and collections for durable records.
- [Add Pages](https://docs.capsule.new/build/add-pages.md): Add product UI to a Capsule app with Python DSL pages and React pages.
- [Background Work](https://docs.capsule.new/build/background-work.md): Run long work and recurring jobs inside the Capsule app.
- [Connect Services](https://docs.capsule.new/build/connect-services.md): Add integrations, secrets, and filesystems to a Capsule app.
- [Deploy An App](https://docs.capsule.new/build/deploy-an-app.md): Serve locally, create workspace resources, and deploy the same Capsule app definition.
- [First Chat App](https://docs.capsule.new/build/first-chat-app.md): Build the smallest useful Capsule chat app.
- [Changelog](https://docs.capsule.new/changelog.md): Notable Capsule documentation and platform updates.
- [App Model And Runtime](https://docs.capsule.new/concepts/app-model-and-runtime.md): How Capsule turns one app definition into a running app.
- [App Styles](https://docs.capsule.new/concepts/app-styles.md): When to use functional apps versus class-based apps.
- [Auth And Scopes](https://docs.capsule.new/concepts/auth-and-scopes.md): How app users, access gates, and scoped data fit together in Capsule.
- [Why Capsule](https://docs.capsule.new/concepts/why-capsule.md): How Capsule combines app auth, runtime, state, UI, tasks, and deploys in one app model.
- [Channels](https://docs.capsule.new/features/channels.md): Connect external message transports to a Capsule app.
- [Chat And Sessions](https://docs.capsule.new/features/chat-and-sessions.md): Handle messages, stream replies, keep session state, and render chat UI blocks.
- [Collections](https://docs.capsule.new/features/collections.md): Store durable records that handlers and pages can query.
- [Custom React Pages](https://docs.capsule.new/features/custom-react-pages.md): Register richer frontend surfaces with `app.add_page(...)`.
- [Filesystems](https://docs.capsule.new/features/filesystems.md): Mount durable file storage into a Capsule runtime.
- [Integrations](https://docs.capsule.new/features/integrations.md): Let app users connect external services like GitHub, Gmail, AWS, and Tailscale.
- [Pages](https://docs.capsule.new/features/pages.md): Add dashboards and app UI with Capsule's Python page DSL.
- [Pricing And Payments](https://docs.capsule.new/features/pricing-and-payments.md): Charge your app users, understand checkout, payouts, Capsule's platform fee, and your workspace billing.
- [Secrets](https://docs.capsule.new/features/secrets.md): Inject workspace-owned credentials into a Capsule app.
- [Tasks And Schedules](https://docs.capsule.new/features/tasks-and-schedules.md): Run async work and recurring jobs without a separate worker stack.
- [Themes](https://docs.capsule.new/features/themes.md): Style hosted Capsule apps from Python.
- [Workflows](https://docs.capsule.new/features/workflows.md): Create named session-backed flows with optional launcher UI.
- [Build AI Apps In Python](https://docs.capsule.new/index.md): Capsule is a framework and hosted runtime for shipping AI apps with chat, pages, state, integrations, tasks, and auth.
- [Installation](https://docs.capsule.new/installation.md): Install `cpsl`, verify the `capsule` CLI, and authenticate to your workspace.
- [Quickstart](https://docs.capsule.new/quickstart.md): Build, serve, and deploy a small Capsule app.
- [App API](https://docs.capsule.new/reference/app-api.md): `cpsl.App` and the core app-building API.
- [Channels, Integrations, And Secrets](https://docs.capsule.new/reference/channels-integrations-and-secrets.md): Channels, user integrations, and secret handling.
- [CLI](https://docs.capsule.new/reference/cli.md): The `capsule` CLI: create, login, serve, deploy, and workspace resources.
- [Client](https://docs.capsule.new/reference/client.md): Programmatic access to deployed Capsule apps with `cpsl.Client`.
- [Collections And Settings](https://docs.capsule.new/reference/collections-and-settings.md): Collections, scopes, columns, and settings.
- [Decorators](https://docs.capsule.new/reference/decorators.md): Lifecycle, message, task, schedule, endpoint, and ASGI decorators.
- [Image, Theme, And Deployment](https://docs.capsule.new/reference/image-theme-and-deployment.md): Runtime images, theming, filesystems, pricing, and deployment settings.
- [Session And Request Context](https://docs.capsule.new/reference/session-and-request-context.md): Sessions, request context, messages, attachments, and runtime helpers.
- [UI And Pages](https://docs.capsule.new/reference/ui-and-pages.md): Page registration, UI widgets, and React page patterns.
- [Workflow API](https://docs.capsule.new/reference/workflows.md): `app.workflow(...)`, `WorkflowInput`, and workflow handler decorators.
- [SDK And Runtime Versions](https://docs.capsule.new/sdk-runtime-versions.md): Understand local `cpsl` versions, hosted runtime versions, and deploy behavior.
- [Troubleshooting](https://docs.capsule.new/troubleshooting.md): Common setup, serve, deploy, auth, secret, and runtime issues.