---
name: adom-nucleus
description: Open the Adom Nucleus to browse your Adom wiki boards/projects (Personal / Organization / Public), view a component's symbol + footprint + 3D and per-EDA layer stackup, add components to your KiCad/Altium libraries, or deliver a self-contained KiCad project to your computer. Triggers include "open the nucleus", "browse my boards", "add this board's parts to my kicad library", "download this project as a self-contained kicad project", "view the layer stackup".
user-invocable: true
---

# Adom Nucleus

A local web app (opened in a Hydrogen webview) for browsing and working with your
Adom wiki boards/projects. Built on `adom-lbr` (it reuses the codec to render +
convert on the fly).

## Run it

```bash
adom-nucleus --port 8785 &
```

Open `http://localhost:8785` in a browser or Hydrogen webview. To surface it in
the user's webview panel, use `adom-cli hydrogen webview open-or-refresh`.

## What's inside

- **Projects tabs** — Personal (your non-org boards), Organization (org boards you
  can access, grouped by org), Public (search box, Enter to load). Starred boards
  pin to the top; the rest are alphabetical.
- **Viewer** — click a board → its components (categorized) → symbol + footprint +
  3D + the KiCad/Altium layer stackup, with pin/pad highlight.
- **Interactive board/schematic panes** — embedded **adom-layout-viewer**
  (`/board-view/<slug>/pcb`) and **adom-schematic-viewer** (`/board-view/<slug>/sch`).
  Net highlighting, per-part hover with live stock/price. The Manager serves
  `/board-view/<slug>/enrich` on their behalf, since an embed has no server of
  its own. Rendered views are cached in-process per slug+version.
- **Add to Library** — selected components into the user's KiCad/Altium libraries.
- **Add Project to my Computer** — a board's full KiCad project; *project-only*
  mode makes it self-contained (project symbol/footprint libraries, re-pointed
  references, project-local lib-tables).

## Prerequisites

- **adom-desktop** bridge running — delivery to the user's machine (Add to
  Library / Add Project, project fetch) and desktop screenshots go through it.
- Signed-in **adom-wiki** session — identity (Personal/Org tabs) and stars.
- **python3** in the container — the self-containment step for Add Project.