Install
Loom ships as a single Unity package tarball. The two npm packages are
bundled inside, so there’s no public npm registry to hit and no separate
native binary to download. Just drop the .tgz into Packages/.
Prerequisites
- Unity 6 (
6000.x). Earlier versions are not tested. - Node 20+ on the host that runs the Editor.
Steps
Drop the tarball. Copy
com.loomgui-X.Y.Z.tgzinto your project’sPackages/directory.Reference it. Add the package to
Packages/manifest.json:{ "dependencies": { "com.loomgui": "file:com.loomgui-X.Y.Z.tgz" // ... your other dependencies } }Restart Unity.
That’s it. You can now setup your first screen on the next step, see Your first screen.
Verifying the install
Open Loom -> Doctor (or Loom -> Status Window for a dockable overlay). The
doctor reports:
- Node.js found
- Native plugin loaded for your platform
- Vite dev server reachable
- Generated
bridge.d.tspresent and current - UI build cache present
If any of these report red, see Doctor reference.
Upgrading
When a newer com.loomgui-X.Y+1.Z.tgz lands, replace the tarball in Packages/, re-run Loom -> Sync UI Dependencies, and restart Unity. Same
one button, every upgrade.