ttui 2.0.0

A terminal UI framework built from first principles: direct control over text rendering, color, pane layout, and multiplexing.
Documentation
# Example apps


Each app is a full vertical-slice demo of the `ttui` framework, built
against a specific vision doc (`TTUI-Ideas/vision/UI/`). Run with
`cargo run --example <name>`.

- **`omnitrix`** — a dial-navigated gadget hub with three sub-apps
  (Brainstorm, Fasttrack, Upgrade) and a materialization boot sequence.
  Built from `TTUI-Ideas/vision/UI/idea-1-Omnitrix.md`.
- **`tardis`** — a hexagonal console hub with four sub-apps (Artron
  Energy, Psychic Paper, Star Charts, plus the Hub itself) and a
  camera-flight transition system. Built from
  `TTUI-Ideas/vision/UI/idea-3-TardisTUI.md`.
- **`smash_crabs`** — a character-select hub with three fighters
  (Versus Mode, Target Smash, Stage Hazards) and a Smash-Bros-style
  intro splash. Built from
  `TTUI-Ideas/vision/UI/idea-2-SuperSmashCrabs.md`.
- **`launcher`** — a cross-app "portal nexus" that presents the three
  apps above as bootable portals and switches between whole apps: each
  launches through its own boot + signature transition, `F12` (or an
  app's own `q`) returns to the nexus, and the nexus's `q` quits. Built
  from `docs/design/specs/launcher/2026-08-08-cross-app-launcher-design.md`.
- **`falcon`** — a scrappy smuggler-freighter cockpit: a windshield
  filling most of the screen (parallax starfield behind a projected
  canopy frame) above three instrument panels (Hyperdrive, Sensors,
  Weapons) with a percussive-maintenance glitch mechanic. The
  windshield overlays a focus-driven HUD — a Hyperdrive trajectory
  line, a Sensors radar sweep, or a Weapons reticle — matching whichever
  panel is currently focused. Built from
  `TTUI-Ideas/vision/UI/idea-4-Falcon.md`.
- **`demo`** — the original core-framework smoke-test example, predates
  the vision-doc apps above. Retirement tracked in issue #83.
- **`render_spike`** — a bare showcase proving out six
  rendering-fidelity levers together; a research-spike prototype, not a
  themed vision-doc app. Built from
  `docs/design/specs/core/2026-08-08-rendering-fidelity-spike-design.md`
  rather than a vision doc.
- **`depth_spike`** — a bare showcase proving out a fixed-forward
  pinhole-camera projection system (points, lines, filled polygons); a
  research-spike prototype, not a themed vision-doc app. Built from
  `docs/design/specs/core/2026-08-10-depth-perspective-projection-spike-design.md`.
- **`mission_control`** — a NASA-style ground-control telemetry console:
  three live sparklines (altitude, velocity, signal strength) and a
  bar chart of subsystem health, all animating via a deterministic
  random walk. Built from
  `docs/design/specs/mission-control/2026-08-12-mission-control-design.md`.
- **`control_panel`** — a retro sci-fi console where clicking is the
  primary interaction: a LAUNCH button (spawns a particle burst),
  three clickable toggle switches, and a clickable mode dial. Built
  from `docs/design/specs/control-panel/2026-08-12-control-panel-design.md`.

Each themed app's `App` type lives in `examples/<app>/<app>.rs` and is
reused by `launcher` via `#[path]`; `examples/<app>/main.rs` is a thin
standalone entry, so `cargo run --example <app>` still runs each app on
its own.