# QORM

> QORM (Query · Observe · Render · Mutate) is an agent-native, cross-platform
> app platform. A QORM app
> is a small, language-neutral JSON bundle (manifest + scenes + actions + an
> optional Go middle-layer) that one pure-Go runtime renders live in a browser,
> snapshots to static HTML, compiles + ed25519-signs into a verifiable bundle,
> delivers over-the-air with rollback, packages as web / iOS / Android /
> desktop, and exposes to AI agents over MCP. No cgo — it cross-compiles
> everywhere.

Dual-consumer by design: every artifact is readable, installable, and writable by
a human developer, and discoverable, derivable, and self-verifiable by an AI
agent. Docs marked "auto-generated" are regenerated from the code and guarded by
tests — trust them over prose. Write apps in the format the runtime accepts
**today**: follow getting-started + the `examples/` + the auto-generated
references below (the runnable sources are the contract).

## Cite this

- One-line: QORM is an agent-native, pure-Go declarative UI runtime — apps are JSON that humans and AI agents build, run, verify, sign, and package together.
- Site: https://qorm.com/
- LLM map (this file): https://qorm.com/llms.txt
- Extended map: https://qorm.com/llms-full.txt
- Source: https://github.com/qorm/platform
- Docs: https://qorm.com/docs/
- API: https://qorm.com/api/

## Start here

- [README](https://github.com/qorm/platform/blob/main/README.md) — what QORM is; run / build / sign / package at a glance.
- [AGENTS.md](https://github.com/qorm/platform/blob/main/AGENTS.md) — a short orientation for AI agents working in this repo.
- [Getting started](https://qorm.com/docs/tutorials/getting-started.html) — install, first app, the run loop.
- [First scene](https://qorm.com/docs/tutorials/first-scene.html) · [First action](https://qorm.com/docs/tutorials/first-action.html) · [First component](https://qorm.com/docs/tutorials/first-component.html)
- [Responsive layout](https://qorm.com/docs/tutorials/responsive-layout.html) — `when`, `viewport.*`, `breakpoint.*`
- [Partial render](https://qorm.com/docs/runtime/partial-render.html) — server-side patch for scalar state updates

## The format (write apps in this)

- [examples/](https://github.com/qorm/platform/tree/main/examples) — the canonical runnable patterns: text via `text`, bind with `{{state.x}}`, `onPress` names an action in `actions/`, components in `qorm.json` with `{{prop.x}}`.
- [Project structure](https://qorm.com/docs/project-structure.html) — the app folder: `qorm.json` manifest, `scenes/`, `actions/`, and the optional `qorm.config.json` host-window block (size/title/resizable/chromeless/transparent → shaped windows).
- [Actions & state](https://qorm.com/api/actions.html) — the step vocabulary, `script` actions in the qscript language (`actions/*.qs` + the shared `actions/lib.qs`), scene `keys`/`swipes`, `computed`.
- [Expressions](https://qorm.com/docs/expressions.html) — the `{{ … }}` language: operators and every builtin (incl. the v2 array/string methods).
- [Widget catalog](https://qorm.com/api/widgets.html) — every node `type` the renderer accepts (auto-generated from `internal/render`, guarded by `TestWidgetCatalogInSync`).
- [Node & style props](https://qorm.com/api/props.html) — node schema + common style keys (~100; canvas filter/mask/snap/FLIP + game motion props).
- [QSS & canvas effects](https://qorm.com/docs/styles.html) — stylesheets + declarative canvas visual effects.
- [Animation](https://qorm.com/api/animation.html) — entrance, spring, FLIP, `fx` (burst…), `timeline` (path/cubic/onComplete/yoyo/stagger), transitionYoyo.
- [Capabilities](https://qorm.com/docs/platforms/capabilities.html) — built-in hardware/OS ops, callbacks, and platforms (auto-generated from `internal/capability`).

## Middle-layer — add your own native ops

- [User middle-layer](https://qorm.com/docs/platforms/native-middlelayer.html) — one `native/desktop.go`; register ops with `qormext.Register`, reach hardware with `qormext.Native`, push UI events with `qormext.Emit`. Compiles into the desktop binary AND the mobile/web WASM.
- [examples/middleware](https://github.com/qorm/platform/tree/main/examples/middleware) · [examples/native-ext](https://github.com/qorm/platform/tree/main/examples/native-ext)

## Platforms

- [Platform support matrix](https://qorm.com/docs/platforms/support-matrix.html) — what works where, at a glance.
- [Mobile](https://qorm.com/docs/platforms/mobile.html) · [Desktop](https://qorm.com/docs/platforms/desktop.html) · [Web](https://qorm.com/docs/platforms/web.html) · [Mini-app](https://qorm.com/docs/platforms/miniapp.html) (static export)

## Examples (runnable — the canonical patterns)

- [counter](https://github.com/qorm/platform/tree/main/examples/counter) · [todo](https://github.com/qorm/platform/tree/main/examples/todo) · [tasks](https://github.com/qorm/platform/tree/main/examples/tasks) — state + actions + lists
- [dashboard](https://github.com/qorm/platform/tree/main/examples/dashboard) — data-viz widgets · [gallery](https://github.com/qorm/platform/tree/main/examples/gallery) — the widget gallery
- [hardware](https://github.com/qorm/platform/tree/main/examples/hardware) · [desktop-hardware](https://github.com/qorm/platform/tree/main/examples/desktop-hardware) — the capability catalog exercised
- [uikit](https://github.com/qorm/platform/tree/main/examples/uikit) — JSON-defined custom components · [i18n](https://github.com/qorm/platform/tree/main/examples/i18n) — ICU messages, plurals, RTL
- [menus](https://github.com/qorm/platform/tree/main/examples/menus) — desktop system-bar / tray / right-click menus · [floating](https://github.com/qorm/platform/tree/main/examples/floating) — chromeless, custom-shape window
- [places](https://github.com/qorm/platform/tree/main/examples/places) — scroll surfaces: a `largetitle` that collapses into a sticky compact bar, a frosted `backdropBlur` panel, and a `sheet` dragged between snap points
- [canvas-fx](https://github.com/qorm/platform/tree/main/examples/canvas-fx) — canvas FX + full game motion: filter/mask/clip (`polygon`)/snap/FLIP, invert/sepia/tint, rotate/scale/flip/skew/`transformOrigin`, `zIndex` stacking, mix-blend extras (`plus-lighter`), pixelated images, `fx` (burst…), `timeline` (path/cubic/onComplete/yoyo), stagger
- [derived](https://github.com/qorm/platform/tree/main/examples/derived) — `computed` cart totals declared once, a `guard` that bounces an unauthenticated checkout to sign-in, and a `forEach` bulk edit
- [tetris](https://github.com/qorm/platform/tree/main/examples/tetris) · [g2048](https://github.com/qorm/platform/tree/main/examples/g2048) · [mario](https://github.com/qorm/platform/tree/main/examples/mario) · [raiden](https://github.com/qorm/platform/tree/main/examples/raiden) — qscript games with canvas `fx` and chiptune `playSound`/`playMusic` (Tetris/2048 keep FX local — flash/banner/outline, not whole-board shake; Mario is NES 1-1 at 2x with `tilemap` + board camera; Raiden shoot/explode)

## Drive it as an AI agent

- [Build with your AI](https://qorm.com/docs/build-with-ai.html) — the human's side: set up your agent, then have it scaffold/edit/verify QORM apps.
- [Human-AI collaboration](https://qorm.com/docs/collaboration.html) — a human and an agent on one live app over SSE + MCP, each seeing the other; the "AI edited" toast and `qorm_activity` close the loop.
- [integrations/](https://github.com/qorm/platform/blob/main/integrations) — drop-in MCP config + per-agent setup (Claude Code/Desktop, Cursor, Windsurf) + a QORM **skill**.
- [Agent skill](https://github.com/qorm/platform/tree/main/integrations/skill/SKILL.md) — runnable format, full MCP tool list, canvas FX, `board` camera + `tilemap`, game motion rules, self-verify.
- [MCP tools](https://qorm.com/docs/agent/mcp-tools.html) — the Model Context Protocol surface to read/edit a live app.
- [Verifying an app](https://qorm.com/docs/verification.html) — default CLI `qorm shot` / `qorm measure` / static `qorm check` use deterministic headless canvas; live MCP reads the active canvas graph or browser/WebView DOM, and `qorm_capture_canvas` returns the native host's last-presented PNG pixels.
- CLI: `qorm new | run | render | shot | measure | check | build | keygen | sign | verify | mcp | preview | package | docs | audit | updates | update | version` — full reference: [api/cli.md](https://qorm.com/api/cli.html).

## Trust & security

- [Bundle signing](https://qorm.com/docs/security/bundle-signing.html) — ed25519 verify-the-bundle delivery.
- [Permission model](https://qorm.com/docs/security/permission-model.html) · [Security model](https://qorm.com/docs/security/security-model.html)

## Commercial use

- [ops/TERMS.md](https://github.com/qorm/platform/blob/main/ops/TERMS.md) — the source is MIT; a good-faith Patreon membership covers commercial white-labeling (custom icon / removing the "Made with QORM" note).