Adom Hydrogen (platform base)
Public Made by Adomby adom
Layer Hydrogen's workspace onto a standard Adom workstation.
name: hydrogen-settings description: > Hydrogen's Settings dialog and the full preference tree the user can change — theme, vim mode, launch-on-login, console-on-startup, 3D control style, font, line numbers, schematic nudge, the embedded Adom Bridge options, and more. READ THIS when the user asks "how do I turn on vim mode", "change the theme", "make Hydrogen launch at startup", "stop Adom Bridge's window popping up", "switch to blender/solidworks orbit controls", "hide line numbers", "show the console on startup", "make the UI compact", or "where are the settings". Opened from the Adom logo menu → Settings. Trigger words — settings, preferences, settings dialog, options, config, theme, dark mode, light mode, high contrast, compact ui, developer mode, vim mode, vim emulation, line numbers, code font, editor font, launch on login, launch on startup, launch on boot, show console, console on startup, 3d controls, control style, fusion solidworks blender orbit, schematic nudge, auto approve, foreground hd, adom desktop window, turn on, turn off, change setting, how do I configure.
Hydrogen Settings — the preference tree
Open it from the Adom logo menu (upper-left teal logo) → Settings (see
hydrogen-adom-menu). The dialog is
src/lib/components/editor/settings/SettingsDialog.svelte; the canonical tree of
sections and keys lives in src/lib/stores/settings.ts (settingsTree).
Preferences are saved per-user (saveUserSetting → PATCH /user/hydrogen/settings)
and persist across sessions. Setting a key back to its default removes the
override. Keys are dotted (section.subsection.name).
The Settings search box is currently a no-op — it's a placeholder input with a
<!-- TODO: Implement settings search -->inSettingsDialog.svelte. Typing in it filters nothing yet; scroll/scan the sections instead.
Sections, keys, and what each does
general
| Key | Default | What it does |
|---|---|---|
general.developer_mode |
false |
Enables extra developer/debugging features in the app |
general.pane_focus_mode |
true |
Only the focused pane is active + highlighted; turn OFF to keep every pane always active |
general.appearance (subsection)
| Key | Default | What it does |
|---|---|---|
general.appearance.theme |
adom-dark |
App-wide theme. Options: adom-dark, adom-light, adom-dark-high-contrast, adom-light-high-contrast (→ "change the theme" / "light mode" / "high contrast") |
general.appearance.user_interface_style |
standard |
UI compactness: standard or compact (→ "make the UI more compact") |
desktop (Hydrogen app itself)
| Key | Default | What it does |
|---|---|---|
desktop.show_console_on_startup |
false |
Show the debug console window when Hydrogen starts (→ "show the console on startup") |
desktop.launch_on_boot |
true |
Auto-launch Hydrogen on login / at startup (→ "make Hydrogen launch at startup" / "stop Hydrogen launching on login" = set false) |
adom_desktop (the embedded Adom Bridge / ab that Hydrogen runs)
When Hydrogen is running it takes over ab, so ab's options live here. See hydrogen-adom-desktop for the Hydrogen↔ab relationship.
| Key | Type / default | What it does |
|---|---|---|
adom_desktop.open |
action button | "Open Adom Bridge" — brings the ab window to the foreground (persists nothing) |
adom_desktop.auto_approve_when_running |
bool, true |
While Hydrogen runs, keep ab in permanent auto-approve mode (auto-accept ab permission prompts) |
adom_desktop.show_window_on_launch |
bool, true |
Show ab's window when Hydrogen launches, so you can see it's running (→ "stop ab's window popping up" = set false) |
adom_desktop.foreground_hd_on_launch |
bool, true |
Bring Hydrogen to the front on launch; ab stays visible but behind Hydrogen |
schematic (Schematic Workspace)
| Key | Default | What it does |
|---|---|---|
schematic.nudge_amount.small |
1 px |
Arrow-key nudge distance for components |
schematic.nudge_amount.large |
8 px |
Shift+arrow nudge distance |
schematic.invert_zoom_direction |
false |
Invert mouse-wheel zoom direction |
schematic.default_cursor |
crosshair |
Default cursor: crosshair or pointer |
3d (3D Settings)
| Key | Default | What it does |
|---|---|---|
3d.control_style |
fusion |
Orbit/pan/zoom control scheme: fusion, solidworks, or blender (→ "use blender/solidworks controls") |
3d.invert_zoom_direction |
false |
Invert mouse-wheel zoom direction in 3D |
code (Code Workspace)
| Key | Default | What it does |
|---|---|---|
code.appearance.font.family |
DM Mono |
Code editor font family (→ "change the code font") |
code.line_numbers.enabled |
true |
Show line numbers (→ "hide line numbers" = set false) |
code.line_numbers.style |
absolute |
Line-number style: absolute or relative |
code.vim_emulation_mode |
false |
Vim motions in the code editor (→ "turn on vim mode" = set true) |
simulator (Simulator Workspace)
| Key | Default | What it does |
|---|---|---|
simulator.code_editor_position |
right |
Code editor position relative to the 3D environment: right or left |
extensions
Present in the tree but currently has no properties (reserved for future extension-specific settings).
Answering common asks
- "Turn on vim mode" →
code.vim_emulation_mode= true - "Change the theme / dark mode / high contrast" →
general.appearance.theme - "Make Hydrogen launch on login / at startup" / "don't launch on login" →
desktop.launch_on_boot - "Stop Adom Bridge's window popping up" →
adom_desktop.show_window_on_launch= false - "Blender / SolidWorks orbit controls" →
3d.control_style - "Hide line numbers / change code font" →
code.line_numbers.enabled/code.appearance.font.family - "Show the console when Hydrogen starts" →
desktop.show_console_on_startup - "Make the UI compact" →
general.appearance.user_interface_style= compact
Related skills
- hydrogen-adom-menu — the logo menu that opens Settings (and Ports, API Explorer, etc.)
- hydrogen-ui — the broader Hydrogen UI / panel layout this dialog sits in
- hydrogen-adom-desktop — what the
adom_desktop.*prefs control (the embedded ab)
---
name: hydrogen-settings
description: >
Hydrogen's Settings dialog and the full preference tree the user can
change — theme, vim mode, launch-on-login, console-on-startup, 3D control style,
font, line numbers, schematic nudge, the embedded Adom Bridge options, and
more. READ THIS when the user asks "how do I turn on vim mode", "change the
theme", "make Hydrogen launch at startup", "stop Adom Bridge's window popping up",
"switch to blender/solidworks orbit controls", "hide line numbers", "show the
console on startup", "make the UI compact", or "where are the settings". Opened
from the Adom logo menu → Settings. Trigger words — settings, preferences,
settings dialog, options, config, theme, dark mode, light mode, high contrast,
compact ui, developer mode, vim mode, vim emulation, line numbers, code font,
editor font, launch on login, launch on startup, launch on boot, show console,
console on startup, 3d controls, control style, fusion solidworks blender orbit,
schematic nudge, auto approve, foreground hd, adom desktop window, turn on, turn
off, change setting, how do I configure.
---
# Hydrogen Settings — the preference tree
Open it from the **Adom logo menu** (upper-left teal logo) → **Settings** (see
[hydrogen-adom-menu](../hydrogen-adom-menu/SKILL.md)). The dialog is
`src/lib/components/editor/settings/SettingsDialog.svelte`; the canonical tree of
sections and keys lives in `src/lib/stores/settings.ts` (`settingsTree`).
Preferences are saved per-user (`saveUserSetting` → `PATCH /user/hydrogen/settings`)
and persist across sessions. Setting a key back to its default removes the
override. Keys are dotted (`section.subsection.name`).
> **The Settings search box is currently a no-op** — it's a placeholder input
> with a `<!-- TODO: Implement settings search -->` in `SettingsDialog.svelte`.
> Typing in it filters nothing yet; scroll/scan the sections instead.
## Sections, keys, and what each does
### general
| Key | Default | What it does |
|---|---|---|
| `general.developer_mode` | `false` | Enables extra developer/debugging features in the app |
| `general.pane_focus_mode` | `true` | Only the focused pane is active + highlighted; turn OFF to keep every pane always active |
**general.appearance** (subsection)
| Key | Default | What it does |
|---|---|---|
| `general.appearance.theme` | `adom-dark` | App-wide theme. Options: `adom-dark`, `adom-light`, `adom-dark-high-contrast`, `adom-light-high-contrast` (→ "change the theme" / "light mode" / "high contrast") |
| `general.appearance.user_interface_style` | `standard` | UI compactness: `standard` or `compact` (→ "make the UI more compact") |
### desktop *(Hydrogen app itself)*
| Key | Default | What it does |
|---|---|---|
| `desktop.show_console_on_startup` | `false` | Show the debug console window when Hydrogen starts (→ "show the console on startup") |
| `desktop.launch_on_boot` | `true` | Auto-launch Hydrogen on login / at startup (→ "make Hydrogen launch at startup" / "stop Hydrogen launching on login" = set false) |
### adom_desktop *(the embedded Adom Bridge / ab that Hydrogen runs)*
When Hydrogen is running it takes over ab, so ab's options live here. See
[hydrogen-adom-desktop](../hydrogen-adom-desktop/SKILL.md) for the Hydrogen↔ab relationship.
| Key | Type / default | What it does |
|---|---|---|
| `adom_desktop.open` | action button | "Open Adom Bridge" — brings the ab window to the foreground (persists nothing) |
| `adom_desktop.auto_approve_when_running` | bool, `true` | While Hydrogen runs, keep ab in permanent auto-approve mode (auto-accept ab permission prompts) |
| `adom_desktop.show_window_on_launch` | bool, `true` | Show ab's window when Hydrogen launches, so you can see it's running (→ "stop ab's window popping up" = set false) |
| `adom_desktop.foreground_hd_on_launch` | bool, `true` | Bring Hydrogen to the front on launch; ab stays visible but behind Hydrogen |
### schematic *(Schematic Workspace)*
| Key | Default | What it does |
|---|---|---|
| `schematic.nudge_amount.small` | `1` px | Arrow-key nudge distance for components |
| `schematic.nudge_amount.large` | `8` px | Shift+arrow nudge distance |
| `schematic.invert_zoom_direction` | `false` | Invert mouse-wheel zoom direction |
| `schematic.default_cursor` | `crosshair` | Default cursor: `crosshair` or `pointer` |
### 3d *(3D Settings)*
| Key | Default | What it does |
|---|---|---|
| `3d.control_style` | `fusion` | Orbit/pan/zoom control scheme: `fusion`, `solidworks`, or `blender` (→ "use blender/solidworks controls") |
| `3d.invert_zoom_direction` | `false` | Invert mouse-wheel zoom direction in 3D |
### code *(Code Workspace)*
| Key | Default | What it does |
|---|---|---|
| `code.appearance.font.family` | `DM Mono` | Code editor font family (→ "change the code font") |
| `code.line_numbers.enabled` | `true` | Show line numbers (→ "hide line numbers" = set false) |
| `code.line_numbers.style` | `absolute` | Line-number style: `absolute` or `relative` |
| `code.vim_emulation_mode` | `false` | Vim motions in the code editor (→ "turn on vim mode" = set true) |
### simulator *(Simulator Workspace)*
| Key | Default | What it does |
|---|---|---|
| `simulator.code_editor_position` | `right` | Code editor position relative to the 3D environment: `right` or `left` |
### extensions
Present in the tree but currently has **no properties** (reserved for future
extension-specific settings).
## Answering common asks
- **"Turn on vim mode"** → `code.vim_emulation_mode` = true
- **"Change the theme / dark mode / high contrast"** → `general.appearance.theme`
- **"Make Hydrogen launch on login / at startup"** / "don't launch on login" → `desktop.launch_on_boot`
- **"Stop Adom Bridge's window popping up"** → `adom_desktop.show_window_on_launch` = false
- **"Blender / SolidWorks orbit controls"** → `3d.control_style`
- **"Hide line numbers / change code font"** → `code.line_numbers.enabled` / `code.appearance.font.family`
- **"Show the console when Hydrogen starts"** → `desktop.show_console_on_startup`
- **"Make the UI compact"** → `general.appearance.user_interface_style` = compact
## Related skills
- [hydrogen-adom-menu](../hydrogen-adom-menu/SKILL.md) — the logo menu that opens Settings (and Ports, API Explorer, etc.)
- [hydrogen-ui](../hydrogen-ui/SKILL.md) — the broader Hydrogen UI / panel layout this dialog sits in
- [hydrogen-adom-desktop](../hydrogen-adom-desktop/SKILL.md) — what the `adom_desktop.*` prefs control (the embedded ab)