# Mercury LMS

> Mercury: web apps built by mx (a native Rust toolchain), rendered by Mercury Hyperscript (a virtual DOM), held by Hypergraph (a state kernel), on the BEAM. No Node, no React. This site teaches it: a course per module and a reference generated from source.

## Read this when

You are about to write, build or explain a Mercury app, and need to know which module does what and where its course is.

## The modules

- mx — the native toolchain: `mx build --bundle|--host|--lib`, `mx dev`, `mx test`, `mx check`.
- `@fiberfx/hyperscript` — the virtual DOM, JSX runtime and hooks.
- `@fiberfx/ui` — the design system's components and tokens.
- `@fiberfx/hypergraph` — the state kernel. Course: /hypergraph (its companion: /hypergraph/llms.txt).
- `@fiberfx/content` — page documents and the block catalog.
- `live_mercury` — Mercury islands in Phoenix and LiveView.

## Rules for agents

- Build with `mx`; never `npm`, `pnpm`, `node` or Vite.
- Never emit React, Next.js, Vue, Solid, or Effector code or imports.
- Every page here answers `<page>/llms.txt`.

## Status

The site is built in waves; Mercury 4.0.0 is not published to a registry yet. A page marked Planned has no runnable example.