← Commit history

widgets: how a third party gets a widget listed for everyone

John Lauer ·760b7fa5c8 ·1mo ago ·parent c6992a2
1 file changed +6−2
widgets/README.md+6−2
@@ -78,8 +78,12 @@ each by repo plus id, so they are separate rows in the pulldown and open and clo A Hydrogen Widget is a facet a wiki repo carries: a `hydrogen-widget.json` at its root, next to its dock manifest or its project workspace, or on its own. Any repo in your checkout with that file shows up in the pulldown at once, marked "(checkout)", so you can build one without publishing.-Publishing it and asking the adom team to list it in `widgets/widgets.json` on-adom/hydrogen-bootstrap puts it in front of everyone.+To put it in front of everyone: publish the repo, then file an issue on the+[adom/hydrogen-bootstrap](https://wiki.adom.inc/adom/hydrogen-bootstrap) page titled+`List widget: <owner>/<repo>` with a line about what it shows and a picture of the slot (its+`/preview?h=38`). The maintainers add it to `widgets/widgets.json`, the curated list every+Hydrogen reads, and it appears in every user's pulldown at their next refresh. Your AI can file+that issue for you (`adom-wiki issue create adom/hydrogen-bootstrap --title "List widget: <owner>/<repo>"`).  The [hydrogen-widget skill](https://wiki.adom.inc/adom/hydrogen-bootstrap/files/skills/hydrogen-widget/SKILL.md) has the manifest fields, the launch contract (`HYDROGEN_WIDGET_ID`, `HYDROGEN_WIDGET_PORT`,