Examples

Clone a working starter and run it on your own tenant in minutes — a reference App and a reference Storefront theme, both deployed with the revenexx CLI.

The fastest way to understand the platform is to run something real on your own tenant. Each starter below clones, installs, and deploys with the revenexx CLI in a few commands. Before you start, install the CLI and have a tenant slug and an X-Revenexx-Api-Key ready (Prerequisites).

Sample App

revenexx/sample-app is a reference App: a greetings entity exposed as a small REST surface (create, list, get, update, delete, plus a digest transform) built on @revenexx/app-sdk. It's the end-to-end loop — manifest → register → deploy → call — in its smallest form.

Clone & deploy
git clone https://github.com/revenexx/sample-app.git
cd sample-app
npm install

revenexx login --token <API_KEY> --tenant <TENANT_SLUG>
revenexx deploy app   # register if new → upload → build → publish → install

Then call it through the gateway — the key must hold a scope covering the capability (e.g. greetings.*):

Call it
curl "https://api.revenexx.com/v1/greetings?limit=20&order=created_at.desc" \
  -H "X-Revenexx-Tenant: <TENANT_SLUG>" \
  -H "X-Revenexx-Api-Key: rvxk_..."

Walk through how it's built in Build your first App.

Sample Theme

revenexx/sample-theme is a reference Storefront theme: a real Nuxt SSR site plus the Blökkli theme contract. Run it locally, then deploy it and reach it on a generated preview domain.

Clone & run
git clone https://github.com/revenexx/sample-theme.git
cd sample-theme
npm install
npm run dev          # preview locally

Deploy it to your tenant with the CLI (create the site first in Cockpit or with revenexx sites create, then list it with revenexx sites list):

Deploy
revenexx login --token <API_KEY> --tenant <TENANT_SLUG>
revenexx sites create-deployment --site-id <SITE_ID> --activate true --code .

For a site connected to a Git repository, push to deploy instead — see Deploy from CLI and Deploy from Git. Build one from scratch in Build your first Theme.

Both starters are kept minimal on purpose — they prove the contract end to end so you can graduate to the full App and Theme tutorials with a working starting point.