# Void Energy UI

> Physics-based, theme-reactive design system for narrative software. Composition (Tailwind) and material (SCSS physics engine) are separated; every surface is the intersection of an atmosphere (palette + font), a physics preset (glass / flat / retro), and a mode (light / dark). The site you are reading is the public showcase. The canonical agent surface ships via npm — see below.

## Install

- `npm install void-energy` — ships the component registry, system prompt, agents.md, composition recipes, cheat sheet, and Anthropic Skill body in the tarball.
- `claude mcp add --transport stdio void-energy -- npx -y @void-energy/mcp` — read-only MCP server for AUTHORING agents (stdio): 26 Resources + 5 Tools (atmosphere registry, component / token / pattern catalog, Safety-Merge validation, Tailwind class validity, silent-failure lookup, markup audit).
- `@void-energy/webmcp` — browser-side WebMCP adapter for RUNTIME agents (Claude in Chrome, ChatGPT Atlas, Edge Copilot, etc.). Mounted in Layout.astro, registers 13 system tools with `navigator.modelContext` so any in-browser agent can switch atmosphere, open modals, fire shortcuts, or navigate the live site. W3C WebMCP draft (May 20 2026); Chrome 149 origin trial, flag-gated in earlier versions via `chrome://flags/#enable-webmcp-testing`.

## Agent-readable artifacts (raw files in the repo)

- [AGENTS.md](https://raw.githubusercontent.com/void-energy/void-energy/main/AGENTS.md): Always-on instructions for the 24-tool agents.md ecosystem (Aider, Cursor, Codex, Devin, Copilot, Junie, Warp, etc.).
- [SYSTEM-PROMPT.md](https://raw.githubusercontent.com/void-energy/void-energy/main/SYSTEM-PROMPT.md): Tool-agnostic portable system prompt. Any LLM can consume this via API and produce constraint-following Void Energy code.
- [SKILL.md](https://raw.githubusercontent.com/void-energy/void-energy/main/skills/void-skill/SKILL.md): Anthropic Claude Skill body — atmosphere-aware physics-driven UI guidance.
- [.cursor/rules/void-energy.mdc](https://raw.githubusercontent.com/void-energy/void-energy/main/.cursor/rules/void-energy.mdc): Cursor Rules.
- [CLAUDE.md](https://raw.githubusercontent.com/void-energy/void-energy/main/CLAUDE.md): Layered Claude Code session instructions (root, src/, src/pages/, packages/*).

## Showcase pages (HTML)

- [Home](https://voidenergy.dev/): Triad-architecture intro and live atmosphere/physics swap.
- [Components](https://voidenergy.dev/components): Every shipped primitive in context. Theme button in nav swaps atmosphere and physics.
- [Atmospheres](https://voidenergy.dev/atmospheres): Brand index. Per-atmosphere pages render under their own atmosphere via page-scoped overrides.
- [Conexus](https://voidenergy.dev/conexus): The narrative storytelling product Void Energy was originally built for.
- [Ambient Layers](https://voidenergy.dev/ambient-layers): Premium ambient effects engine.
- [Kinetic Text](https://voidenergy.dev/kinetic-text): Premium kinetic-text + narrative engine.
- [Participation](https://voidenergy.dev/participation): Foreign-markup physics participation contract (`data-ve-surface`, `data-ve-content`).
- [WebMCP](https://voidenergy.dev/webmcp): Runtime agent surface — system tool catalog, live engine snapshot, and feature-detect status for browser-resident agents using `navigator.modelContext`.

## Per-atmosphere machine-readable artifacts (served by this site)

Every atmosphere in the launch slate exposes a JSON token payload and a markdown DESIGN.md spec snapshot:

- `https://voidenergy.dev/atmospheres/{brand}/{atmosphere}.json` — `ExternalThemePayload` (id, mode, physics, palette, optional brand profile).
- `https://voidenergy.dev/atmospheres/{brand}/{atmosphere}.md` — spec-conformant DESIGN.md per atmosphere.

Browse [/atmospheres](https://voidenergy.dev/atmospheres) for the full list of brand and atmosphere ids.

## Source

- Repository: https://github.com/void-energy/void-energy
- License: BSL-1.1