Files
artcraft-services/frontend
Tanish Manku 97173bee39 viewer-3d: free models on swap and unmount, and drop late loads
Switching models or closing the viewer only removed the model from the
scene, so every GLB's buffers and textures and every splat's buffers
stayed on the GPU. A model that finished loading after the URL changed
or the viewer unmounted was still added to the scene.

Model teardown now frees the model, and loads that finish after their
effect was cleaned up are freed instead of shown. Unmount frees the
whole scene (only the placeholder cube was freed before) and forces the
context loss, which is safe here because the viewer owns its canvas and
has already detached it.

The existing render spec failed because jsdom has no ResizeObserver;
stub it and add an unmount-before-init case.
2026-10-06 15:50:13 -07:00
..
2026-03-12 15:49:24 +07:00
wip
2026-09-14 15:40:33 -04:00

Frontend

This is the Nx workspace for ArtCraft web apps and shared libraries. The desktop frontend is maintained in storytold/artcraft.

All commands to run these projects are performed from this directory (except the repo-root launcher scripts noted below).

Requirements

  • Node.js 20+ (Nx 21 / Vite 6 requirement). Install via nvm, nodejs.org, or brew install node.
  • npm (ships with Node).

We use npm, not pnpm. pnpm was briefly adopted ("add pnpm to solve build issues") and later removed ("fix(frontend): consume video-editor libs via nx path aliases, drop pnpm"). If you have leftovers from that era — a pnpm-lock.yaml, pnpm-workspace.yaml, or a node_modules/.pnpm directory — npm installs will fail (typically with ENOTEMPTY rename errors). See Troubleshooting below.

Install dependencies

npm install

Running the apps in dev mode

From the repository root, the launcher scripts (these preflight your environment, install dependencies, and free the dev port first):

./script/website/unix_frontend_website_dev.sh  # artcraft-website (marketing site), port 4200
./script/website/unix_frontend_webapp_dev.sh   # artcraft-webapp (user dashboard), port 4201

Run the webapp from artcraft-services, not the separate artcraft desktop checkout. The webapp launcher also works from another directory when invoked by its full or relative path:

../artcraft-services/script/website/unix_frontend_webapp_dev.sh

Or directly from this directory:

nx dev artcraft-website
npx nx dev @frontend/artcraft-webapp

Building

npx nx build artcraft-website
npx nx build artcraft-webapp

Netlify deploys run apps/<app>/script/netlify_build.sh (see each app's netlify.toml).

Troubleshooting

npm install fails with ENOTEMPTY: directory not empty, rename ...

Your node_modules tree is corrupted — usually an interrupted install, or a tree written by pnpm back when the repo briefly used it. Fix:

./clean_modules.sh
npm install

Or the manual minimum:

rm -rf node_modules .nx pnpm-lock.yaml pnpm-workspace.yaml
npm install

Stale build state after switching branches

Call this when starting on main or a new branch:

./clean_modules.sh

It removes all dist/ outputs, resets the nx cache, and removes node_modules.

Import aliases

The names for @frontend and @storyteller come from the package.json file in the libs folder:

import { Login } from "@frontend/login";
import { api } from "@storyteller/api";

For shared UI components, import from @storyteller/ui-[componentname]:

import { Button } from "@storyteller/ui-button";
import { Modal } from "@storyteller/ui-modal";

Generating a new component library

# 1. Generate the library
npx nx g @nx/react:library libs/components/toaster --import-path=@storyteller/ui-toaster --bundler=vite
npm install

# 2. Import it somewhere in code

# 3. Sync and build
nx sync
nx build