Museum

What Is the Museum?

The kbllr-museum is a separate repository (~/kbllr-museum/) — a living gallery app built with React + Vite + Three.js. It hosts 21 interactive exhibits, each in its own directory with an exhibit.manifest.json, optional screenshots, and snapshot data. The gallery UI runs on :5310 with a backend API on :5311.

Running the Museum (Verified Path)

cd ~/kbllr-museum/ui
npm install        # first time
npm run dev        # starts gallery UI on :5310 (runs data:sync + vite)

Open http://localhost:5310 — the gallery grid shows all 21 exhibits. Click any exhibit to open it in the viewer.

Available Scripts (~/kbllr-museum/ui/package.json)

npm run dev        # data:sync && vite (port 5310)
npm run build      # tsc -b && vite build
npm run preview    # vite preview
npm run data:sync  # sync exhibit data from manifests
npm run museum:sync # full museum sync

Locating “flash-ui-core”

The flash-ui-core exhibit is a viewer-only snapshot — it contains exhibit.manifest.json, screenshots/, and snapshot/ but has no standalone src/ or package.json. It cannot be launched independently; it renders inside the museum’s gallery viewer.

To view it: launch the museum (npm run dev in ~/kbllr-museum/ui), open http://localhost:5310, find flash-ui-core in the exhibit grid.

The manifest’s run_command field ("npm install && npm run dev") is metadata describing the exhibit’s original build process, not a standalone launch instruction. The exhibit directory has no package.json to run against.