← Commit history

Widgets page: each widget's own page, private widgets

John Lauer ·8d5435742d ·1mo ago ·parent 59c7e25
1 file changed +24−1
widgets/README.md+24−1
@@ -1,6 +1,14 @@ # Widgets: small live panels in the title bar -![Three widgets in the Hydrogen title bar: Claude usage, Codex usage and a clock](widgets/title-bar-widgets.png)+![The full Title Bar: Claude usage with its 5-hour, weekly and Fable rows stacked, Codex usage, and the clock, left of the CPU/RAM meter](widgets/title-bar-widgets.png)++Compact Title Bar, one row per widget:++![The compact Title Bar: the same widgets as a single row each](widgets/title-bar-compact.png)++The Hydrogen Widgets pulldown:++![The Hydrogen Widgets pulldown: Claude usage and Codex usage with their vendor marks, Clock, and the Make your own Hydrogen Widget link](widgets/widgets-pulldown.png)  The bar across the top of the Hydrogen window is the **Title Bar** (the Adom menu, the meters, the widgets, the bell, your avatar and the window controls); the chevron at the top edge makes@@ -39,6 +47,21 @@ Nothing in the pulldown needs a mouse. On Hydrogen's control API:  UI-bus commands `widgets.menu.open` and `widgets.menu.close` do the same as the pulldown click. +## Each widget's own page++Every row in the pulldown links to that widget's page on its wiki repo (the `docs` field in its+manifest, `widgets/README.md` by default): a picture of it in the full and compact Title Bar, what+it shows and where the numbers come from, how often it asks, the files in the repo that make it a+widget, and a link to the SDK. The shipped ones: [Claude and Codex usage](https://wiki.adom.inc/adom/adom-vscode/files/widgets/README.md)+and [Clock](https://wiki.adom.inc/adom/hydrogen-bootstrap/files/widgets/README.md).++## Private widgets++Hydrogen reads the widget list and every manifest with your own sign-in, so a widget on a private+wiki repo shows for the people the page is shared with and nobody else. Keep a repo private with+`adom-wiki page create --private` and share it with `adom-wiki page share`; a private widget comes+from your checkout or your own list, not from the curated one.+ ## Making your own  A widget is a facet a wiki repo carries: a `hydrogen-widget.json` at its root, next to its dock