OpenCoven UI is a small, inspectable workspace for exploring interface
direction before it enters a production application. The current artifact,
Components.dc.html, is a self-contained HTML, CSS, and
JavaScript component browser with no dependency installation or build step.
This repository is not a packaged component library, production app, or canonical source for Coven Cave components.
Use the specimen navigation to move between four interface states:
| State | Purpose |
|---|---|
| Composer | Keeps drafting, context, model, and send controls legible without competing with the message. |
| Messages | Presents a familiar response as an editorial turn with clear identity, provenance, response, and utility hierarchy. |
| Context | Makes attached repositories, files, branches, and access state explicit. |
| Actions | Uses direct verbs, visible consequences, and secondary keyboard cues. |
The browser preserves visible focus states, arrow-key navigation, reduced-motion handling, and a responsive layout without horizontal overflow at 390px.
git clone https://github.com/OpenCoven/ui.git
cd ui
open Components.dc.htmlNo install step is required. On platforms without the macOS open command,
open Components.dc.html directly in a browser.
The same Messages hierarchy contracts naturally on narrow screens while keeping the response aligned beneath Cody's identity.
| Path | Purpose |
|---|---|
Components.dc.html |
Self-contained interactive component browser |
artifacts/ |
Verified desktop and mobile visual receipts |
docs/superpowers/specs/ |
Approved design decisions |
docs/superpowers/plans/ |
Implementation plans and verification steps |
handoffs/ |
Completion and validation receipts |
When changing a specimen:
- Keep the browser self-contained unless a separately approved design changes the repository architecture.
- Preserve all four states and the existing navigation semantics.
- Verify embedded JavaScript parsing, four-state selection, arrow-key navigation, and 390px horizontal overflow.
- Refresh both desktop and mobile screenshots when visual behavior changes.
- Record exact commands and results in the relevant handoff receipt.
The current implementation plan contains the exact specimen verification commands.