# Control room · Penstock

The control-room screen of a small town’s water-treatment works, on a Quiet page. The process line runs across the top as stations on a groove (Intake, Screens, Clarifier, Filters, Chlorine contact, Reservoirs, Town zones), each with its lamp, its state in words and one key number, and a station in alarm shows it. Under it the plant’s panels. A row of function keys, F1 to F6, switches the screen (the real keys work too); F1 is the whole grid and each other key shows that subsystem larger; on a phone it is a tab bar and every key is a screen of its own. The values tick every few seconds and pause when the tab is hidden; Hand makes a pump’s speed fader live, Off and a new setpoint ask first, an alarm is raised on its own, flashes until it is acknowledged and goes when its cause clears. Both finishes, both volumes, reduced motion, and loading, empty (the outstation has not reported), link-lost (last values greyed with their age) and view-only states.

Template · With the Kit · https://tactileui.dev/templates/console

> The code and styling for this template come with the Tactile UI Kit, which the Pass and the Founder Pass include. Sign in if you have it. Sign in: https://tactileui.dev/auth/sign-in The price: https://tactileui.dev/pricing

## Anatomy

- [Bar](https://tactileui.dev/parts/bar): The top of a page: a wordmark with a lamp, printed links, and one contrast key at most.
- [Panel](https://tactileui.dev/parts/panel): A face plate that groups what belongs together: a head, a rule, then the parts. Screws only on device-like panels.
- [Pipeline](https://tactileui.dev/parts/pipeline): The stages of a build and a deploy as stations along a groove, like the program track of a machine. Each station is a socket with a lamp in it (green for a stage that passed, red for one that failed, amber and breathing for the one running, an empty socket for one that is waiting or was skipped) and under it the stage’s name, its state in words, how long it took and a Log key. Ink runs along the groove as far as the run has got. Wide, the stages stand in a row; narrow, they stand in a column with the groove down the side.
- [Meter](https://tactileui.dev/parts/meter): A value inside a known range, read off an LED strip. The strip is a native meter element, so low, high and optimum are the browser’s own: the whole lit length takes the colour of where the value stands (green in the good region, amber next to it, red beyond), not the colour of the segment it has reached. The marks under the strip print where the regions begin, and cut lines across it show the same two places. Words say the state too.
- [LCD](https://tactileui.dev/parts/lcd): A value that changes, on grey-green liquid crystal, with a ghost of the unlit segments behind it: clocks, battery, counters.
- [VFD](https://tactileui.dev/parts/vfd): A vacuum-fluorescent display: cyan-white light on near-black glass, with a glow and a ghost. Frequencies, levels, status screens.
- [Selector](https://tactileui.dev/parts/selector): One mode of two to five: latching keys in a tray, one down at a time, each with a lamp that lights when chosen.
- [Readout](https://tactileui.dev/parts/readout): A printed label over a value: key figures, with the unit small and the change in words.
- [Fader](https://tactileui.dev/parts/fader): A continuous value along a line: a native range whose cap rides in a slot cut into the plate, with a printed scale.
- [Knob](https://tactileui.dev/parts/knob): A rotary control for continuous or stepped values where space is square. Its knurl and pointer turn; its light does not.
- [Sparkline](https://tactileui.dev/parts/sparkline): A word-sized line for the margin of a table or beside a readout. It is an SVG that takes the size of the type around it and the ink of the place it sits in, so on a panel it is ink and on display glass it is the display’s light. The last value is marked with a dot seated in a faint ring, and a lamp lights the dot when the reading matters. The trend and the last value are said in words on the image’s label, so the line is a second sign and never the only one.
- [Chart recorder](https://tactileui.dev/parts/recorder): A strip-chart recorder: gridded paper advancing under a pen that rides a rail, drawing the live value as the paper moves and printing the time in the margin. For p95 latency, tokens per second, grid frequency, a cold room’s log.
- [Needle gauge](https://tactileui.dev/parts/gauge): A moving-coil panel meter: a printed scale under glass, a thin needle that swings past the mark and settles, a lamp for the bands and a small LCD for the exact reading.
- [Stat tile](https://tactileui.dev/parts/stat-tile): One headline number with its label, how it moved against another period and, if you give it readings, the small line of the run behind it. The label and the figure are the readout, set on a plate; the figure is formatted with the money field’s own helpers, so pounds, dollars and plain counts group the way the locale does. Say which way is better and a kit lamp and the word Better or Worse join it, so a fall in refunds can be good news; leave it out and nothing is judged. A tile can be loading (the skeleton with its amber lamp) or empty, and a screen reader hears one sentence for the whole tile.
- [Table](https://tactileui.dev/parts/table): The TUI table is rows of data with printed column labels, figures right-aligned in columns, and status in lamps with words.
- [Lamp](https://tactileui.dev/parts/lamp): The only colour in the kit: a lamp that is on. Green is on, amber is waiting, red is recording or failing, blue is linked, white is standing by. Always next to words.
- [Status](https://tactileui.dev/parts/status): A lamp with words: the state line in tables, panel heads and lists. The words carry the meaning; the lamp is the glance.
- [Tag](https://tactileui.dev/parts/tag): A small printed plate: a type, a count, a badge. Solid for the one tag that must stand out.
- [Log stream](https://tactileui.dev/parts/log-stream): A live log printed on a strip of paper tape. Each line is a time, a printed legend for its level (debug, info, warn, error) and its words, set between the sprocket holes of the tape. A lamp in the head says whether the tape is following the newest line (green, Following) or has been left where you are reading (amber, Paused, and how many lines have come since); a key jumps back to the latest. Over the tape sits a filter well: a search field and the four levels as chips. It is a display: it prints what the page gives it, keeps the last thousand lines and runs nothing.
- [Uptime strip](https://tactileui.dev/parts/uptime-strip): A row of ticks, one for each day or hour, on a strip of dark glass, each tick a lamp in its own slot, with the percentage on an LCD above. A lit green lamp is a period that was up; amber lit in the lower half only is one that was degraded; red lit across but cut by a slit is one that was down; a lamp that is out is a period with no reading. Move across the strip, or use the arrow keys, and the tick you are on is read out in words under it. A key below spells the four lamps.
- [Timeline](https://tactileui.dev/parts/timeline): An event log like the roll of a chart recorder. The rail is engraved down the plate and each event is a tick stamped across it, with its time in tabular figures and its words beside it. A lamp on the rail is the only colour, and a marker for the present separates what has happened from what is still to come.
- [Form validation](https://tactileui.dev/parts/validation): A form that says what is wrong, on the browser’s own checks. Press submit with something missing and each field in error gets a line under it with a red lamp lit and words that say how to put it right, its well ringed red; at the top of the form an annunciator lights over a count and a list that links to each field, and takes the focus. From then on each field is checked again as it changes.
- [Text area](https://tactileui.dev/parts/textarea): Longer text in a deeper recess: notes, messages, descriptions. It grows by its corner handle.
- [Popconfirm](https://tactileui.dev/parts/popconfirm): A small card that asks before a click does its work, hung from the key that opened it. It is the popover, placed by the popover’s own rules and tied to its key by the same printed leader, holding a short question, an optional second line, and Cancel and Confirm keys. Escape and a click outside both cancel it, and the focus goes back to the key. For a destructive act it takes the danger tone: the kit’s red lamp before the question and a danger Confirm key, with no new colour. It is the guard on a delete in a table row, where a dialog is too heavy.
- [Alert dialog](https://tactileui.dev/parts/alert-dialog): The dialog plate for a question that must be answered before an act that matters. A caution strip is set across its head with one lamp in it, red when the act cannot be undone and amber when it can. The question is the title, one sentence says what will happen, and a grave act can ask for its name to be typed first.
- [Toggle key](https://tactileui.dev/parts/toggle-key): One key that latches below the plate and stays there. It is the kit’s own key with one state to keep, down or up, so it is the way to say mute, pin, bold or armed without the weight of a switch. A lamp in the cap may light while it is down.
- [Key](https://tactileui.dev/parts/key): Every button, and every link that acts like one: a cap on a skirt that drops below the plate when pressed.
- [Tab bar](https://tactileui.dev/parts/tab-bar): A mobile app’s bottom navigation, in place of the plain of three to five icon-and-label links fixed to the foot of the screen. The one you are on is marked by a single pill that slides along the tray, a pocket milled into the metal, and by the lit green in its icon and label. Press a tab and the pill answers at once; drag it and it follows your finger, then goes to the nearest tab. A count sits on an icon as a small printed cap and is spoken. It is markup, a stylesheet and a small script (wireTabBar) that makes and moves the pill; without the script the current link wears the pocket itself.
- [Tooltip](https://tactileui.dev/parts/tooltip): A few words on a small label plate, the kind riveted beside a control on a rack: printed in the contrast colours with a rule just inside its edge and a short tab aimed at its key. It comes up when a pointer rests on the key or the keyboard reaches it, is read by a screen reader, and goes on Escape.
- [Spec list](https://tactileui.dev/parts/spec): Key and value facts, printed like the plate on the back of a device.
- [Alert](https://tactileui.dev/parts/alert): A message let into the surface, with an annunciator: a small lit legend (Note, Done, Check, Fault) beside the words that say what happened.
- [Empty state](https://tactileui.dev/parts/empty-state): What a view shows before it has anything: an empty tray with the outline of what goes in it printed on its floor, one sentence and one key.
- [Skeleton](https://tactileui.dev/parts/skeleton): The shape of a page before its data arrives, drawn as the unprinted plate: blank engraved bars where the words will print. Nothing on it moves. One amber lamp beside “Loading” is the only sign of work.
- [Toast](https://tactileui.dev/parts/toast): A confirmation after an action.

## Usage notes

A sample-data strip · Bar with the name, the works, a site clock on an LCD, the shift and operator, a link status and an alarm summary key that flashes while anything is unacknowledged · the process line as the hero, a pipeline of seven stations each with a lamp, a state word and one key number · under it three columns of panels: Reservoirs (an LCD and a meter with printed limits and low and high lamps for each), Chlorine dosing (a vacuum display, a detented knob for the setpoint that confirms in an alert dialog with old and new, a sparkline), the Supply record (an uptime strip of 30 days) · High-lift pumps (a Hand, Off and Auto selector, a run lamp, a speed readout and a fader that is live only in Hand; Off confirms in an alert dialog that says where Hill Top stands) and Flow and pressure (a recorder with two pens over 8 hours and the zone pressures) · Alarms (a table with a priority lamp, an Acknowledge key per row, Acknowledge all on a popconfirm, and an event journal on a log stream) over the Shift log (a timeline and a validated form with a textarea) · function keys F1 to F6 along the foot as toggle keys, and a tab bar on a phone · a key at the foot that shows the other states (?state=).
