# Mercury LMS

> Mercury combines mx (the native Rust toolchain), Hyperscript (its own DOM runtime), Hypergraph (state) and Mercury UI. Phoenix and LiveView integration is available through Live Mercury. The archive/image workflow invokes native mx without Node.js or npm CLI. The published @fiberfx/mx@0.1.0 npm wrapper requires Node 18+ for each mx invocation. Mercury uses Hyperscript, not React.

## HTTP resources

- [API index](https://mercury.jonnify.com/api): public read-only resources and access policy.
- [OpenAPI description](https://mercury.jonnify.com/openapi.json): HTTP contracts for discovery, release metadata and MCP.

## When to use Mercury

Use Mercury when the user wants to build or refine a browser interface with Hyperscript components, Mercury UI and CSS tokens; model reactive state with Hypergraph; or develop and bundle a Mercury app with the native mx CLI. Use Live Mercury when an existing Phoenix or LiveView application needs Mercury islands.

Start by inspecting the user's existing application and dependency pins. For a standalone HTML page, follow the [browser guide](https://mercury.jonnify.com/start/browser/llms.txt). For native TSX development, check [installation readiness](https://mercury.jonnify.com/start/install-mx/llms.txt), then the [first-app workflow](https://mercury.jonnify.com/mx/first-app/llms.txt). Read the [Mercury API reference](https://mercury.jonnify.com/reference) for exact module contracts, and load the [Mercury skill](https://mercury.jonnify.com/agent/SKILL.md) for implementation and verification steps.

Do not migrate an unrelated working framework without the user's request. The documentation also has a read-only MCP server at https://mercury.jonnify.com/mcp for skills, mx platform guidance and component prompts; [connection guide](/start/mcp). It does not execute commands or install software. Verify styling, keyboard access and the actual requested interaction in a browser; a successful import alone is insufficient.

## Choose a route

Keep an existing app or working mx. Without a CLI, start with [browser HTML](/start/browser/llms.txt). For native TSX, check [npm and archive readiness](/start/install-mx/llms.txt). [The Mercury skill](/agent/SKILL.md) selects by environment and task; the counter is not a substitute for checking the user's requested interactions.

## Design Book

- [Mercury Design Book](https://mercury.jonnify.com/book): nine source-faithful chapters and an interactive Design Lab for SVG, typography, spacing and semantic colors.
- [Book agent guide](https://mercury.jonnify.com/book/llms.txt): editable source, PDF, token files and reusable brand-book/design-builder skills.

## Practice interface design

- [Mercury Craft](https://mercury.jonnify.com/craft): practice action hierarchy, spacing and reading measure in a settings form and a second context.
- [Craft agent guide](https://mercury.jonnify.com/craft/llms.txt): exercise workflow, public manifest and evidence limits.
- [Mercury Practice](https://mercury.jonnify.com/practice): ten Reflect control exercises with genuine Mercury UI: search, edit, configure, organize and review sample work; English and [Russian](https://mercury.jonnify.com/ru/practice).
- [Practice agent guide](https://mercury.jonnify.com/practice/llms.txt): the ten exercises, their instructions, the [exercise index](https://mercury.jonnify.com/practice/exercises.json) and copyable implementation briefs.

## The modules

- mx — the native toolchain: `mx build --bundle|--host|--lib`, `mx dev`, `mx test`, `mx check`. Course: /mx.
- mg — Mercury Go: source generation from a checkout with Go 1.26+. `scripts/mg help`. [mg](/mg/llms.txt) · [First steps](/mg/first-steps/llms.txt).
- `@fiberfx/hyperscript` — the virtual DOM, JSX runtime and hooks. Course: /hyperscript.
- `@fiberfx/ui` — the design system's components and tokens. Course: /ui.
- `@fiberfx/hypergraph` — the state kernel. Course: /hypergraph (its companion: /hypergraph/llms.txt).
- `@fiberfx/reflect` 4.1.1 — model/view bindings, derived props, scopes and composition. [Course](/reflect), [agent companion](/reflect/llms.txt).
- `@fiberfx/content` — page documents and the block catalog. Course: /content.
- `live_mercury` — Mercury islands in Phoenix and LiveView. Course: /live-mercury.

## Rules for agents

- Use mx for a native app, or plain JavaScript for the browser-only route. npm may bootstrap the published native mx package; it is not the native app build tool.
- Never emit React, Next.js, Vue, Solid, or Effector code or imports.
- Every page here answers `<page>/llms.txt`.
- Every English companion, in course order, in one file: /llms-full.txt

## Status

The Phoenix `mercury_lms` website serves the bilingual homepage at / and /ru. The native app example retained under `sites/mercury` is a separate application. Check /start/stability for module readiness and /start/install-mx for the current installation route. Registry publication alone does not prove a working native install: follow the steps and check the result at /mx/first-app. A page marked Planned has no runnable example.

## Native first page

- [Mercury page-building skill](/SKILL.md).
- [Install mx](/start/install-mx/llms.txt): public archives and SHA-256 verification.
- [First page](/mx/first-app/llms.txt): styled Card + Button counter, dev and build.

Start in a new directory on Linux x86_64. Keep the starter mx.mod and mx.sum. Import @fiberfx/ui/styles.css. The browser runs JavaScript; BEAM is optional.

## Navigation

- [Read this page in the browser](/)
- [Agent index](/llms.txt)
- [All English companions](/llms-full.txt)
- [Sitemap](/sitemap.xml)
- [Mercury API reference](/reference)
- [About Mercury](/about)
- [Contact](/contact)
- [Privacy](/privacy)
- [Public Mercury repository](https://github.com/fiberfx/mercury)
- [/content](/content/llms.txt)
- [/hypergraph](/hypergraph/llms.txt)
- [/hyperscript](/hyperscript/llms.txt)
- [/live-mercury](/live-mercury/llms.txt)
- [/mx](/mx/llms.txt)
- [/mg](/mg/llms.txt)
- [/start](/start/llms.txt)
- [/ui](/ui/llms.txt)
- [Русский индекс](/ru/llms.txt)

- [Русская Дизайн книга](https://mercury.jonnify.com/ru/book): полный перевод девяти глав и лаборатории; [руководство для агентов](https://mercury.jonnify.com/ru/book/llms.txt).