@solumflow-app/product-configurator 0.1.0 → 0.3.0

package/README.md

@@ -76,7 +76,29 @@ export function Configurator({ product }: { product: { id: string; fields: Recor
 
 Pass `labels` for another language, `locale` and `currency` for amounts, and
 style it through the CSS variables `--pc-bg`, `--pc-surface`, `--pc-fg`,
-`--pc-accent` and their neighbours.
+`--pc-accent` and their neighbours. All of them are optional: without them the
+configurator takes your page's own text colour and mixes its greys from it, so
+it reads on a light page and on a dark one. It never follows the visitor's
+system preference on its own -- a page that stays white while the system is
+dark would otherwise get white text.
+
+The scene itself is not yours to tune, on purpose: the lighting (one of three
+presets), the materials with their relief and gloss maps, and the 3D models of
+fixed parts are all set in the CRM, so the configurator looks the same in the
+object builder, on the product page and on your site. The canvas background is
+transparent; your page decides what is behind it. The reflections come from a
+room three.js builds in the browser, so nothing is fetched from a CDN.
+
+### Content Security Policy
+
+If your site sends a CSP, allow the CRM's storage origin in two directives:
+
+- `img-src`: textures and their maps are loaded as images;
+- `connect-src`: 3D models (`.glb`) are fetched.
+
+Blocked, neither shows an error on the page, only a line in the console: a
+texture stays a plain colour and a model stays an empty block in the
+material's colour.
 
 ## Send a request (server action)