From c95d711d4bb04fbcc8afd39c62b59ff4193aa93d Mon Sep 17 00:00:00 2001 From: vangel76 Date: Wed, 4 Nov 2026 00:45:25 +0100 Subject: [PATCH] Web: document the browser minimums the SIMD build needs (#2786) Co-Authored-By: Claude Sonnet 5.5 --- README.md | 2 +- packaging/web/README.md | 17 +++++++++++++++++ 2 files changed, 18 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 8a3c453c5..85dc265cc 100644 --- a/README.md +++ b/README.md @@ -317,7 +317,7 @@ Installers and executables are code-signed. | Build | File | Notes | |---|---|---| -| Static site | `vectorcraft-web-.zip` | Runs in a modern browser; host it on any static server | +| Static site | `vectorcraft-web-.zip` | Runs in a browser with WebAssembly SIMD (Chrome/Edge 91, Firefox 89, Safari 16.4 or newer), see `packaging/web/README.md`; host it on any static server | ## The Crafting Apps diff --git a/packaging/web/README.md b/packaging/web/README.md index 38a8d6209..cac402c6b 100644 --- a/packaging/web/README.md +++ b/packaging/web/README.md @@ -50,6 +50,23 @@ location /vectorcraft/ { Local test: `python3 -m http.server 8765` inside the folder, then open http://localhost:8765/. +## Browser requirements + +The wasm is built with WebAssembly SIMD (`-C target-feature=+simd128`, `.cargo/config.toml`, +#2786), so it needs a browser that has it: + +| Browser | First version | +|---|---| +| Chrome, Edge | 91 | +| Firefox | 89 | +| Safari (macOS and iOS/iPadOS) | 16.4 | + +Source: caniuse `wasm-simd` and the WebAssembly feature table (webassembly.org/features). An older +browser can't compile the module. There is no fallback build and no message: the page stays on +"Loading VectorCraft..." and the console shows a WebAssembly compile error. The app also needs +WebGPU or WebGL2 (see "Renderer selection" below). If you must serve older browsers, put a +version check in front of the app on your own page. + ## Fonts folder Builds made with craft-fonts (`CRAFT_FONTS_DIR`, all releases) have a `fonts/` folder beside the