Canonical contracts

Schemas for the Revenue Cloud

One source of truth. Console, the platform build worker and every editor that follows a $schema URL validate against these files live, so the file you read here is the file your deployment is measured against.

Get started

Apps

Build capabilities the whole platform already understands.

An app extends the platform declaratively. It brings its own tables, its own admin UI and its own settings, and the platform generates the API, the migrations and the Cockpit screens around them.

manifest.schema.json

App Manifest

Identity, dependencies, permissions and events. The base file for your entire app.

schema.schema.json

Database Schema

The tables your app owns. Declare them once, the platform provisions them.

cockpit.schema.json

Cockpit (Administration)

The admin screens your app contributes, as lists, detail views and forms.

settings.schema.json

App Settings

What an operator can configure for your app, per tenant and per market.

manifest.capabilities.schema.json

API Capabilities

The typed API operations your app offers other apps through the gateway.

billing.schema.json

Billing

Your pricing and your marketplace listing. The file that puts the app on sale.

analytics.schema.json

Analytics

Flat views over your entities, ready as datasets for reporting and BI tools.

search.schema.json

Search

Search collections, projected flat and kept in sync for full-text search.

Themes

Create stunning experiences based on clear standards.

A theme is a shareable, sellable Site. It registers in the same registry as an app, is served on its own domain, and carries the editor payload for the pages it ships with it.

theme.schema.json

Theme Manifest

Identity, the site it serves, the capabilities it needs and the editor payload.

billing.schema.json

Billing

Your pricing and your marketplace listing, the same file an app ships.

theme-preset.schema.json

Theme Preset

The pages, menus and brand settings a tenant gets when installing your theme.

theme-extensions.schema.json

Theme Extension

Blocks a theme extension adds to a theme, served from its own Site and sanitised.

theme-events.schema.json

Theme Events

The events your storefront emits for tags and analytics, closed against personal data.

Integrations

Connect any system without writing glue code.

An integration package ships workflow nodes for the Integration Studio. It registers like any other extension, with the same identity and the same marketplace listing, and the SDK describes its nodes.

manifest.schema.json

App Manifest

The package identity: name, vendor, version, title and type, in one file.

billing.schema.json

Billing

Your marketplace listing and pricing, where an integration is actually sold.

AgentsComing soon

Put AI to work on real commerce data.

The agent contract is still being designed. How an agent registers, what it exposes and how a tenant configures it are open questions, and the answer will be published on this host.