main
John Lauer Publish 0.1.0 d8a45ab

name: hydrogen-welcome description: >- The Hydrogen welcome page shown after setup completes ("Your workspace is ready"): a page built into the app and served by the control API, not the adom.inc homepage. Use when asked about the welcome page or tab, or to show the welcome page again.

Hydrogen Welcome Page

The welcome page is static/welcome.html, compiled into the Hydrogen app. Hydrogen's control API serves it at <control URL>/welcome.html?control=<control port>. The control parameter tells the page's buttons which port to call, and the port is dynamic: read it from ~/.adom/hd-control-url (47084 by default). localhost:1420 is the dev server and does not answer on an installed build.

What it shows

  • The Adom logo and "Your workspace is ready"
  • A checklist: VS Code, Your AIs (who is signed in), Adom skills, Adom Bridge
  • Manage AIs when an AI is signed in, or Choose your AI when none is
  • While the workspace is still starting (after an update, a reload or a wake) the AI and Adom Bridge rows say checking instead of "none signed in" or "starting up", and recheck every 5 s until they have a real answer (1.0.734+)

After someone signs in to an AI in the Choose-your-AI dialog (the first-run one or the one this page's button opens), Hydrogen opens a new chat with that AI when the dialog closes, Claude first if several were signed in, with an empty chat box (1.0.745+). Nothing is typed for them.

On Linux the Adom Bridge row reads "not running" until Hydrogen has installed and started Adom Bridge, which it does when a Linux build is published for the user's account; desktop features (screenshots, KiCad, pup) wait for it. Everything else on the page does not depend on it.

When it appears

  • Automatically as the final setup step, the open-welcome gate (the last step of the setup cascade for the active runtime).
  • Any time on request (below).

How to open it

C=$(cat ~/.adom/hd-control-url)
adom-cli hydrogen webview open-or-refresh \
  --name Welcome \
  --url "$C/welcome.html?control=${C##*:}" \
  --panel-id desktop-pane-right

Setup's own step runs this same command. Then look: if the tab is listed but the pane still shows the previous tab, run adom-cli hydrogen workspace active-tab --name Welcome.

IMPORTANT: This is NOT

It is static/welcome.html from the Hydrogen repo, served locally by the control API.

Panel type

Webview tabs in Hydrogen use panel type adom/a1b2c3d4-0031-4000-a000-000000000031. Do NOT use panelType: "webview": that shows "Unknown panel type" error.