HAAM product edition · Vessel 01
Product Studio
A material viewer for one fictional object, with shareable lighting, camera and stills.

Target interaction specification
Product Studio
What does this object look like in this material, construction state, camera, and light, and can I send someone exactly that view?
Product Studio must preserve a one-to-one relationship between manipulation, visible object state, and shareable URL state. Once the person takes control, the system must not secretly move the camera or reset the view behind them.
Case-study thesis
What the finished product should prove.
This is the behavior to build toward. The implementation receipts below remain the record of what exists today.
The product is not a 3D render. It is a stable relationship between hand movement, object state, camera state, material state, and a URL another person can reopen.
State model
The interface has to make these states real.
If two states would look identical to the person, the implementation is not finished.
Poster
A meaningful first frame appears before WebGL or the full scene is ready.
Ready
The object, current material, camera, environment, and available manipulations are legible.
Direct manipulation
Pointer or touch movement maps continuously to the object or camera without mode ambiguity.
Material transition
Changing material keeps object identity stable and communicates any paired light or environment change.
Construction view
Exploded and wireframe states reveal how the object is made without leaving the catalogue context.
Share ready
The current material, camera, environment, construction state, and view serialize into the URL.
Exported
A still is created with enough state in its filename to remain identifiable later.
Fallback
No WebGL, denied clipboard, save-data, or export failure still leaves a useful and recoverable experience.
Edge cases
The boring failures are part of the product.
- WebGL is unavailable or crashes after loading
- The URL contains an invalid material or camera value
- Clipboard permission is denied
- The user switches material during a drag
- A touch gesture could mean page scroll or object rotation
- Reduced-motion or save-data is enabled
- The export buffer cannot be created
Definition of done
The future case study needs these receipts.
- A shared URL opened in a clean session restores the same material, camera, environment, exploded, and wireframe state
- Mouse and touch manipulation both preserve a clear mapping between gesture and result
- Manual camera control is never overridden by an unsolicited camera animation
- Invalid URL state degrades to documented defaults instead of a broken scene
- No-WebGL mode still presents the object, its identity, and the ability to understand what the studio is for
PBR skins
4Abyss glass, Moon pearl, Solar pollen, Liquid chrome. Material select also sets camera and light.
of 008
001One object. Implied year 3026. HAAM Atelier catalogue fiction.
studio state
URLm, c, e, x, w encode material, camera, environment, exploded, and wireframe.
export name
PNGhaam-vessel-01-{material}-{camera}-{YYYYMMDD}.png
The job
Look at it the way a catalogue object is looked at.
Material viewers often arrive as engineering demos. I wanted Vessel 01 in a room: named materials, a designed camera, a paired environment, construction, and a still you can take away.
The looking
Meet the object. Change the skin. Keep the view.
01
Arrive on a still
A static poster holds the first frame so the page has something to see before the scene is ready.
02
Choose a material
Four PBR skins share one object. Choosing a material also chooses camera choreography and a preferred environment.
03
Inspect construction
Exploded and wireframe states live in the same URL as the beauty view, so construction is part of the catalogue, not a hidden debug flag.
04
Share or export
Share copies the canonical URL. If the clipboard is denied, a toast shows the URL. Export writes a PNG with a deterministic filename.
Design decisions
Decisions.
Catalogue
One object is enough if the looking is designed.
Edition 001 of 008. Four named skins with codes and a short lore line. The studio does not become a general configurator by adding a fifth unrelated mesh.
State
The URL is the studio notebook.
Query keys m, c, e, x, and w serialize the view. Invalid values fall back in tests. A share is therefore a specific looking, and a reload does not invent a different one.
Export
A still needs a name that can be filed.
The PNG filename carries material, camera, and date so a folder of exports remains searchable. There is no locked 1920×1080 buffer in this pass.
The working stack
Built with.
Scene
Three.js + R3F
StudioScene lazy-loads. React 19, Three.js 0.185, React Three Fiber 9.
State
studioState.ts
Canonical query shape for material, camera, environment, exploded, and wireframe.
Entry
Static first frame
index.html poster plus noscript note. Vite 8 production build.
Host
studio.haam.co
Published showcase. Local Vite remains the development path.
In evidence
Evidence.
01Four named materials share one inspectable object
02A shared URL restores the same studio view
03A PNG export carries material, camera, and date in the filename
04WebGL-less visitors keep the poster instead of an empty stage
Where it stops
Packaging tests cover the URL, not device FPS.
There is no visual-regression suite, no Playwright flow, and no dated device FPS or Lighthouse capture in the evidence file. Touch and keyboard on real phones are not yet in evidence.
No awards, production-traffic, or measured performance claims belong here.
HAAM’s role
I framed the object, then I made the looking shareable.
Catalogue frame, material naming, camera choreography, environment pairing, React/Three.js studio, URL state, export naming, tests, and documentation. Direct work, 2026.
Research
Tested lighting, materials, camera position and interaction on one object.
Help improve this website?
Optional analytics. Google Analytics and Clarity load only if allowed; form, email, and chat content are excluded.