Guides

Widget & styling

Customize the hosted booking experience with widget configs in the dashboard—colors, copy, flow, and allowed resources.

Widget configurations

In the dashboard, create one or more widget configs per tenant. Each stores theme JSON (light/dark palettes, typography, radii), flow steps, field definitions, verification mode, and optional resource allow-lists. Set a default config for embeds.

The embed page loads config via GET /api/widget/config using your publishable key and widget id.

Hosted embed URL

Pattern

https://YOUR_APP_URL/embed/TENANT_UUID?key=baas_publishable_xxx&widget=WIDGET_CONFIG_UUID

Additional query parameters may apply depending on your implementation (e.g. pre-selected resource). See the embed page source for supported options.

Headless / full custom UI

Skip the iframe entirely: call /api/widget/availability and /api/widget/booking from your design system. You own every pixel; BaaS enforces business rules and payments on the server.

No theme query shortcut

Styling is driven by stored widget config JSON, not a single ?theme=dark toggle. Use the dashboard editor or PATCH the config via the API.