# Stayblox Developer Platform

> Documentation for building Stayblox apps (Developer GraphQL API) and storefront themes (Liquid). The full corpus is available at https://dev.stayblox.com/llms-full.txt

## Themes

- [Build themes](https://dev.stayblox.com/themes/): A theme controls how a public **storefront** looks and renders
- [Partner API](https://dev.stayblox.com/themes/api): Everything the [Stayblox CLI](/themes/cli) does goes through this REST API
- [Assets](https://dev.stayblox.com/themes/assets): CSS and JavaScript bundled in your theme are served at a URL matching their
- [Building themes with AI](https://dev.stayblox.com/themes/building-with-ai): Stayblox themes work well with AI coding agents such as Claude Code and Cursor
- [Stayblox CLI](https://dev.stayblox.com/themes/cli): `@stayblox/cli` is the developer CLI for building and publishing marketplace
- [Getting started](https://dev.stayblox.com/themes/getting-started): Scaffold a minimal theme, preview it on a development site, and validate it
- [Storefront data (GraphQL)](https://dev.stayblox.com/themes/graphql): Themes fetch data — unit types, cart totals, site settings — through a small
- [Publishing](https://dev.stayblox.com/themes/packaging): There are two ways a theme gets onto a storefront, for two different audiences:
- [Store previews](https://dev.stayblox.com/themes/screenshots): Marketplace preview images are captured automatically: the platform renders
- [Theme settings](https://dev.stayblox.com/themes/settings): Settings let hosts customise your theme (colors, labels, toggles) without
- [Theme structure](https://dev.stayblox.com/themes/structure): A theme is a directory of layout, views, sections, snippets, config, and
- [Templating](https://dev.stayblox.com/themes/templating): Themes render with **Liquid** (the same language Shopify themes use, via the

## Apps

- [Build apps](https://dev.stayblox.com/apps/): Apps are remote integrations that run on your server and connect to Stayblox over the **Developer GraphQL API**
- [Embedded pages](https://dev.stayblox.com/apps/app-pages): An embedded app page gives your app a UI surface inside the host panel: a
- [Assignment provider apps](https://dev.stayblox.com/apps/assignment-providers): An assignment provider is an app that decides **who** does a task: a cleaning
- [Becoming a partner](https://dev.stayblox.com/apps/becoming-a-partner): Building apps or themes for Stayblox requires a **verified partner account**
- [Building apps with AI](https://dev.stayblox.com/apps/building-with-ai): AI coding agents can build Stayblox apps end to end: scaffold, explore the GraphQL API, handle webhooks, and validate the manifest, all through the Stayblox CLI's MCP server
- [Categories](https://dev.stayblox.com/apps/categories): Every app in the Stayblox App Store belongs to one **category** and one more
- [Channel apps](https://dev.stayblox.com/apps/channels): A channel app connects a Stayblox property to an OTA (Airbnb, VRBO, Booking.com,
- [Stayblox CLI: apps](https://dev.stayblox.com/apps/cli): The `stayblox app` command group lets you author, publish, and debug apps from the terminal
- [App icon](https://dev.stayblox.com/apps/design): Your app icon is the first thing a host sees in the App Store, on the install
- [Getting started](https://dev.stayblox.com/apps/getting-started): This walks you from zero to a running app with a live GraphQL call on a team
- [GraphQL reference](https://dev.stayblox.com/apps/graphql): The full Developer API schema below is **generated from the SDL** that backs the
- [Inbox channel-provider apps](https://dev.stayblox.com/apps/inbox-channel-provider): A channel-provider app lets you bring a new messaging channel into Stayblox, for
- [Injections](https://dev.stayblox.com/apps/injections): Injection apps render small HTML snippets (analytics pixels, chat widgets,
- [Management API](https://dev.stayblox.com/apps/management-api): The Management API (`/dev/*`) is the REST surface you call as a **developer** to author and manage your apps
- [Configuration (`app.toml`)](https://dev.stayblox.com/apps/manifest): `app.toml` is the config file for your app
- [Metafields](https://dev.stayblox.com/apps/metafields): Metafields are app-owned data fields that you attach to bookings, properties,
- [OAuth install](https://dev.stayblox.com/apps/oauth): The OAuth install flow lets hosts connect their Stayblox account to your app
- [Payment apps](https://dev.stayblox.com/apps/payments): A payment app lets hosts charge buyers at checkout through your provider
- [PHP SDK](https://dev.stayblox.com/apps/php-sdk): ::: info Requires Laravel
- [App lifecycle](https://dev.stayblox.com/apps/publishing): This page covers the full lifecycle of a Stayblox app: choosing a distribution, pushing versions, releasing (and rolling back), and the review pipeline for public apps
- [Reference app: Stripe](https://dev.stayblox.com/apps/reference-app): The fastest way to understand a payment app is to read one
- [Scopes](https://dev.stayblox.com/apps/scopes): Scopes define what a host consents to share with your app at install time
- [Connecting self-hosted plugins](https://dev.stayblox.com/apps/self-hosted-connect): There are two ways an app obtains a host's per-install API token, and which one
- [Signing & security](https://dev.stayblox.com/apps/signing): Every signed exchange between Stayblox and your app (outbound session calls and
- [Tasks](https://dev.stayblox.com/apps/tasks): Tasks are the platform's operational work (cleanings, maintenance, inspections,
- [Versioning](https://dev.stayblox.com/apps/versioning): The Developer API uses **dated versions**, like Shopify
- [Webhooks](https://dev.stayblox.com/apps/webhooks): Stayblox pushes events to your server as they happen

## AI agents

- [AI agents & UCP](https://dev.stayblox.com/agents/): Every Stayblox storefront speaks the [Universal Commerce Protocol](https://ucp.dev)
- [ACP checkout](https://dev.stayblox.com/agents/acp): Stayblox storefronts can also speak [ACP](https://www.agenticcommerce.dev)
- [Discovery & catalog](https://dev.stayblox.com/agents/catalog): The storefront's MCP server lives at `https://{storefront-domain}/api/mcp`
- [Checkout & booking](https://dev.stayblox.com/agents/checkout): Five UCP checkout tools are registered when the storefront takes instant

## Other

- [/](https://dev.stayblox.com/): name: Stayblox Developer Platform