New guide — React Viewer Integration: Minimal Setup to Production

[Vectreal-Admin]

We've published a step-by-step guide for integrating @vctrl/viewer into a React app — from npm install to a production-ready, SSR-safe component.

What the guide covers:

• Installation (@vctrl/viewer @vctrl/hooks three)
• The minimum working viewer using ModelProvider and useLoadModel
• Loading a published scene by URL
• The SSR-safe pattern using lazy() + a client-only boundary + Suspense — the same pattern the Vectreal Platform uses to render the Publisher inside its own React Router v7 app
• The five props you'll actually reach for: model, theme, cameraOptions, controlsOptions, envOptions
• A production checklist (lazy chunk, error boundary, loading thumbnail, AGPL compatibility review)

Verified against:

• @vctrl/viewer v0.17.0
• React ^18 || ^19
• Three.js ^0.177.0 (peer dep)
• AGPL-3.0-only

All packages are pre-1.0. Pin versions in production until v1.0.

Read the full post → https://vectreal.com/news-room/react-viewer-integration

Source for the package → https://github.com/Vectreal/vectreal-platform/tree/main/packages/viewer