Beamline UI

The complete Beamline library and how to choose from it: a selection guide (screens and kits, data → control, screen craft, looks and install), then every screen and component with what it is for and what to use instead. To find parts for a request, call beamline_find first. Call this before designing and read every part in order; each answer names the next. Choose by the person's workflow and data: a block when its job, data and actions fit, otherwise the parts it is composed from; the most specific element for every item.

Exact details of Beamline elements: the import, required and typed props, states, keyboard, motion, the parts to style and working examples to copy. Call it for every element you chose, blocks included, before writing code with it; never guess props. Many ids come back in parts: call again with the same ids and the next part. A block's compose: lines list the parts it is built from, your kit when it fits only partly. Examples use gallery data; pass your own records in the documented types. A 🔒 element returns its description and uses, without code or props. Not for choosing elements: that is beamline_capabilities.

Call this whenever the person asks for any screen, page or control (a booking screen, a data table, a date range picker): returns the best Beamline screens and parts for it, with their kind of app, free or paid, page, picture and what each screen is built from. Free to call; no sign-in. Pass their words as ask; app narrows to one kind of app; screen returns a screen and its parts. Then beamline_component for the ids you choose and beamline_install with all of them.

One command that adds the chosen Beamline elements and a look (default prism) to the app: only those packages, one stylesheet and the look. Pass every element the screens need in one call; call it again to add more later. Run the command in the app folder, import the stylesheet once and pass the installed look to UIRoot. In an app that already has Beamline, pass installed (its release): the answer says when a newer one is out. Elements outside the person's packs are refused, naming the pack that has them.

Inspect a candidate's layout and states, compare plausible choices, or show the person how a part looks. Returns one labelled states sheet in dark or light Prism and a public URL. Pictures of 🔒 elements are available too; their code still needs access. Choose pictures that resolve a design question rather than requesting the whole catalogue. This previews a library part, not the app you compose from it.