3D viewer & client previews
Embedding the marketing STL viewer on product pages and proposal links.
Overview
The Katura 3D viewer renders STL meshes directly in the browser using WebGL — no plugins, no downloads. It powers three surfaces: the admin design previewer, the client-facing proposal page, and the marketing CAD landing page.
Features
- Orbit, pan, zoom with mouse / touch / scroll.
- Studio HDR lighting tuned for polished metal — gold actually looks like gold.
- Material toggle — switch between yellow gold, white gold, rose gold, platinum, and matte for inspection.
- Wireframe overlay for verifying mesh topology.
- Auto-rotate for marketing & hero use.
- Fallback render — if WebGL is unavailable, a static rendered image is shown instead of breaking.
Embedding on a product page
For SKUs linked to a CAD file, the viewer is automatically embedded on the product detail page. To embed on an arbitrary page (e.g. a custom landing page), use the<MarketingStlViewer src="/api/public-cad/<slug>" /> component, whereslug is a key in the public asset whitelist (seeCAD asset permissions).
Customer proposal links
When you click Send proposal in /admin/design, Katura mints a short-lived signed URL that wraps the admin proxy. The viewer loads from that URL, so the customer sees the actual file with no auth — but the link expires (default 14 days) and can be revoked from the admin at any time.
Tip
For maximum customer wow-factor, send proposal links via Yen with the consultation context. Yen will ask permission to walk through the design and answer questions inline.