golem-ui

A React component kit whose first reader is an agent. Nine components — shell, chat, record list, record form, report, timeline, upload, editor, auth — cover the bones of a small app that several people use together. A person never assembles a screen from them by hand; an agent does, from a sentence of intent, and every choice in the kit is judged by whether that makes the agent's output right the first time.

Every component has the same outer shape: config and adapters. Config is plain JSON-serializable data — what the component is — validated by a schema on mount, with unknown fields rejected and a bad value drawing a loud error card that names the field and the rule. Adapters are how the component talks to the world: records, files, identity, chat, clock, navigation. A component never imports a data layer, a router or a fetch. It calls what it was handed.

The split is the whole trick. Config is generated, adapters are wired, so a wrong query never reads as a wrong layout. The kit ships an in-memory fake of every adapter, so stories, tests and the showcase run with no backend and no network. The docs are generated from the same schemas that do the validating, which is why what the agent reads cannot drift from what runs.