3D Viewer Design
Public Made by Adomby adom
Design rules for any Adom 3D viewport — always Babylon, 5-tier layering on the canonical viewer, v1.3 brightened gradient both ends (#5a6b7e → #2a3340, field-proven to keep black chips visible everywh
Skills
The skills this repo ships, by tier, each with a quick health read. Install the user skills with:
adom-wiki skills install adom/3d-viewer-designDesign rules for any 3D viewport Claude generates inside Adom — CAD, EDA, mechanical, PCB, component preview, schematic 3D, molecule viewer, any WebGL canvas. The headline rule: always use the Adom Babylon viewer at `gallia/viewer/` as the baseline — don't rebuild from scratch, extend it. Covers engine choice (Babylon, never Three), canonical-viewer reuse + upstream contribution workflow, background color (gradient, never pure black/white), HDRI + hemispheric lighting, PBR material fixups, ArcRotateCamera defaults including zoom-to-mouse AND Shift+Alt+Click orbit-center recentering (Fusion 360 / Onshape style), ViewCube / view presets, **world- origin axis helpers (always on — critical because origins are where every Adom 3D integration bug hides)**, measurement markers, and AI-drivability hooks. Read this BEFORE you pick `scene.clearColor`, import any 3D library, or design any camera interaction. Trigger words: 3D viewer, 3D viewport, scene background, clear color, Babylon scene, adom 3d viewer, adom babylon viewer, canonical viewer, CAD background, PCB viewer, component viewer, GLB viewer, STEP viewer, 3D preview, viewport design, 3D scene setup, 3d bg color, HDRI, environmentSpecular.env, bottom light toggle, camera limits, zoom to mouse, zoom to cursor, orbit center, recenter rotation, shift alt click, fusion 360 orbit, onshape orbit, ViewCube, view cube, view presets, axis helper, axes helper, origin axes, show origin, world origin, mesh origin, coordinate system, xyz gizmo, measurement marker, Babylon vs Three.js.
No dev skills in this repo.
How to build, debug, and test this app. Source-only (dev-skills/), never shipped in the tarball.
No publish skills in this repo.
The app-to-wiki publish glue. Source-only (publish-skills/), never shipped in the tarball.
Health: the size chip is green when right-sized, yellow when getting long, red when the model likely skims it. A green check is a passed preamble/structure signal; an amber mark is a gentle nudge, not a hard failure.