← Commit history

Initial commit: app/adom-tsci

Kyle Bergstedt ·3d64cc40c3 ·4mo ago
2 files changed +131
README.mdadded+75
@@ -0,0 +1,75 @@+# 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:++```bash+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++```bash+# 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)
page.jsonadded+56
@@ -0,0 +1,56 @@+{+  "schema_version": 1,+  "type": "app",+  "slug": "adom-tsci",+  "title": "adom-tsci — Tscircuit Board Viewer",+  "brief": "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",+  "version": "1.3.94",+  "tags": [],+  "license": "MIT",+  "discovery_triggers": [+    "tscircuit preview",+    "adom-tsci",+    "tsci dev webview",+    "preview tscircuit",+    "interactive tscircuit viewer",+    "rerun autorouter",+    "re-run autorouter",+    "walkthrough demo",+    "board walkthrough",+    "sharper silkscreen",+    "bump texture resolution",+    "publish molecule to wiki",+    "export tscircuit to wiki",+    "live 3d viewer for this board",+    "x-ray view pcb",+    "auto-glow nets",+    "AI-driven 3D pcb viewer",+    "place usb-c",+    "rotate usb-c",+    "UsbCReceptacle",+    "usb-c east edge",+    "type-c"+  ],+  "discovery_pitch": "Author tscircuit boards in TSX, preview the result with a full 3D viewer (Components/Nets HUDs, Walkthrough, Inspect, Measure, x-ray view), and one-shot publish the molecule to the Adom Wiki with the live interactive viewer + source bundle + plan.md attached.",+  "install": {+    "binary_name": "adom-tsci",+    "install_dir": "",+    "install_hint": "",+    "version_cmd": ""+  },+  "readme": "# adom-tsci — Tscircuit Board Viewer\n\nAn Adom-Docker CLI that gives you **first-class 3D / PCB / Schematic\ntabs** for a tscircuit project inside a Hydrogen webview, plus the\ncanonical \"ship this molecule to the wiki\" flow.\n\n## What it does\n\n- **3D tab** — full Babylon-based viewer (orbit, zoom, ortho/perspective)\n  with the tscircuit GLB loaded, ground shadow, IBL environment.\n- **Components HUD** — every chip / passive / testpoint / machine pin\n  the GLB ships, grouped by kind. Click a row to hide that component\n  and see the traces underneath.\n- **Nets HUD** — every routed pcb_trace lifts off the baked surface\n  as a live polygon mesh on top of an x-ray-transparent substrate. The\n  `✦` button auto-selects the biggest power/ground net the moment you\n  open the panel — that's the gorgeous GlowLayer x-ray shot the\n  walkthrough demos.\n- **Walkthrough Demo** — narrated tour of the board with cinematic\n  camera flyovers. Drives by `walkthrough.json` you can hand-edit per\n  project. Auto-plays in static-export mode (wiki embed).\n- **Inspect / Measure** — Fusion 360-style smart picking. Hover any\n  pad/hole/chip/silkscreen/board for an info card; pin two clicks for\n  a measurement.\n- **Re-run autorouter** — one-click hot reload, regenerates traces\n  + GLB without restarting tsci dev.\n- **export-wiki** — bundle the running viewer + source + plan.md and\n  publish to the Adom Wiki as a molecule page.\n\n## Install\n\nAuto-discover-friendly, single command:\n\n```bash\ncurl -fsSL https://wiki-ufypy5dpx93o.adom.cloud/static/apps/adom-tsci/adom-tsci -o /tmp/adom-tsci \\\n  && chmod +x /tmp/adom-tsci \\\n  && sudo install -m 0755 /tmp/adom-tsci /usr/local/bin/adom-tsci \\\n  && adom-tsci install\n```\n\n`adom-tsci install` deploys SKILL.md + the `adom-usbc`,\n`demo-recording`, and `export-wiki` guides to `~/.claude/skills/`.\n\n## Quick start\n\n```bash\n# Boot the preview against any tscircuit project (lib/index.tsx convention):\ncd ~/project/adom-tsci-projects/My-Board\nadom-tsci start . --port 8861 --tsci-port 3061 --texture-resolution 4096\n\n# Drive the running viewer programmatically:\nadom-tsci view top\nadom-tsci net --on            # x-ray view, auto-glow on biggest net\nadom-tsci walkthrough start   # narrated tour\nadom-tsci toggle-component U1 --hide   # see traces under the chip\n\n# Publish to the wiki as a molecule:\nadom-tsci export-wiki . \\\n  --slug my-board \\\n  --page-type molecules \\\n  --label \"Live 3D viewer\"\n```\n\n`export-wiki` bundles the static viewer + a tarball of the project\nsource (lib/, package.json, walkthrough.json, **plan.md**) + uploads\nthe plan.md standalone so a future agent picking up your molecule\nsees both the brief and the source in one place.\n\n## See also\n\n- `adom-tsci/guides/adom-usbc.md` — USB-C placement / rotation / lint\n- `adom-tsci/guides/demo-recording.md` — making a 30-second narrated\n  demo video of a board\n- `adom-tsci/guides/export-wiki.md` — the molecule publish flow\n  (hero image, plan.md, body completeness rules)\n",+  "author": {+    "id": "695820315b5f1e4db2fcf602",+    "name": "Kyle Bergstedt",+    "email": "[email protected]"+  },+  "visibility": {+    "public": true+  },+  "hero": null,+  "sample_prompts": [],+  "metadata": {},+  "created_at": "2026-05-28T05:29:11.948Z",+  "updated_at": "2026-05-28T05:29:11.948Z",+  "skills": []+}\ No newline at end of file