Platform v2

Build hosted apps for Manaurum

Manaurum v2 apps run as containerised services routed at <slug>.apps.manaurum.com, rendered in shell iframes, and reach the platform through a typed HTTP capability gateway. Author by chat (App Builder), by AI in your IDE (Manaurum skill), or by CLI from your editor.

📦 Containerised hosting🔑 Capability gateway🤖 AI codegen⌨️ CLI deploy🏢 Per-tenant isolation

Three creation paths

✨

App Builder

For tenant admins and non-engineers

Describe an app in plain language inside Manaurum. Builder generates manifest + frontend, deploys to the hosted runtime, and installs it in your workspace. Under an hour from prompt to working app.

🧩

Manaurum skill (Claude / Cursor)

For developers in their IDE assistant

Install the manaurum-dev-sdk plugin in Claude Code or Cursor. The skill scaffolds the project, knows the manifest v2 + capability surfaces, and drives the CLI for you. Same artifacts as the CLI path — no lock-in.

⌨️

manaurum CLI

For experienced developers and teams

pip install manaurum-cli. Write your app in your editor, validate locally, deploy from your terminal. CI-friendly: every deploy is a versioned, append-only snapshot in R2 storage.

What v2 gives you

📦

Real containers

Your code runs as your container at <slug>.apps.manaurum.com — not as JSON in a shell window.

🔌

Capability gateway

12+ typed surfaces: os.kv, os.files, os.ai.complete/embed, os.notifications, os.ocr, os.secrets, os.events, os.apps.call, more.

🔁

Inter-app contracts

Apps call each other via RPC or async events, with bulk-export streams for analytics use cases.

🛡️

Tenant isolation

Per-(app, tenant) Postgres schemas, RLS-enforced. App can never read another tenant's data.

📜

Versioned deploys

Every deploy is an append-only R2 snapshot. Rollback to any prior version in one command.

🔑

mna_* credentials

Per-developer tokens that authenticate the CLI and your hosted handlers. No tenant-scoped key juggling.

Ready to build?

Legacy v1 — still works, no new features

Existing v1 apps (single HTML + postMessage SDK, iframe runtime) keep working unchanged. The legacy SDK lives at /sdk/manaurum.js and /sdk/manaurum.mjs; the v1 manifest schema lives at /sdk/manifest_v1.schema.json. No new features land on v1 — every section below documents the v2 path first and links to legacy details where they differ.