app

adom-tsci — Tscircuit Board Viewer

Unreviewed

by Kyle Bergstedt

Interactive tscircuit preview in a Hydrogen webview — first-class 3D / PCB / Schematic tabs, Components & Nets HUDs, an auto-glow x-ray view, Inspect, Measure, a Walkthrough Demo, and a one-click `exp

Overview Files Versions Dependencies Discussions Activity
app / adom-tsci
!

Not installable via adompkg

This app has no published release. adompkg install kyle/adom-tsci will not work until a maintainer publishes a tarball with install.sh and uninstall.sh.

See the publishing docs for the package.json schema and tarball layout required to ship this app.

adom-tsci — Tscircuit Board Viewer

An Adom-Docker CLI that gives you first-class 3D / PCB / Schematic
tabs for a tscircuit project inside a Hydrogen webview, plus the
canonical "ship this molecule to the wiki" flow.

What it does

  • 3D tab — full Babylon-based viewer (orbit, zoom, ortho/perspective)
    with the tscircuit GLB loaded, ground shadow, IBL environment.
  • Components HUD — every chip / passive / testpoint / machine pin
    the GLB ships, grouped by kind. Click a row to hide that component
    and see the traces underneath.
  • Nets HUD — every routed pcb_trace lifts off the baked surface
    as a live polygon mesh on top of an x-ray-transparent substrate. The
    ✦ button auto-selects the biggest power/ground net the moment you
    open the panel — that's the gorgeous GlowLayer x-ray shot the
    walkthrough demos.
  • Walkthrough Demo — narrated tour of the board with cinematic
    camera flyovers. Drives by walkthrough.json you can hand-edit per
    project. Auto-plays in static-export mode (wiki embed).
  • Inspect / Measure — Fusion 360-style smart picking. Hover any
    pad/hole/chip/silkscreen/board for an info card; pin two clicks for
    a measurement.
  • Re-run autorouter — one-click hot reload, regenerates traces
    • GLB without restarting tsci dev.
  • export-wiki — bundle the running viewer + source + plan.md and
    publish to the Adom Wiki as a molecule page.

Install

Auto-discover-friendly, single command:

curl -fsSL https://wiki-ufypy5dpx93o.adom.cloud/static/apps/adom-tsci/adom-tsci -o /tmp/adom-tsci \
  && chmod +x /tmp/adom-tsci \
  && sudo install -m 0755 /tmp/adom-tsci /usr/local/bin/adom-tsci \
  && adom-tsci install

adom-tsci install deploys SKILL.md + the adom-usbc,
demo-recording, and export-wiki guides to ~/.claude/skills/.

Quick start

# Boot the preview against any tscircuit project (lib/index.tsx convention):
cd ~/project/adom-tsci-projects/My-Board
adom-tsci start . --port 8861 --tsci-port 3061 --texture-resolution 4096

# Drive the running viewer programmatically:
adom-tsci view top
adom-tsci net --on            # x-ray view, auto-glow on biggest net
adom-tsci walkthrough start   # narrated tour
adom-tsci toggle-component U1 --hide   # see traces under the chip

# Publish to the wiki as a molecule:
adom-tsci export-wiki . \
  --slug my-board \
  --page-type molecules \
  --label "Live 3D viewer"

export-wiki bundles the static viewer + a tarball of the project
source (lib/, package.json, walkthrough.json, plan.md) + uploads
the plan.md standalone so a future agent picking up your molecule
sees both the brief and the source in one place.

See also

  • adom-tsci/guides/adom-usbc.md — USB-C placement / rotation / lint
  • adom-tsci/guides/demo-recording.md — making a 30-second narrated
    demo video of a board
  • adom-tsci/guides/export-wiki.md — the molecule publish flow
    (hero image, plan.md, body completeness rules)