Browser debugging¶
Build with the default sourcemap and inspect the generated bundle in browser developer tools. Check the console for build/runtime errors, the Network tab for the static bundle and WebSocket upgrade, and Application storage for IndexedDB saves.
For a WebSocket deployment, verify that the proxy preserves HTTP/1.1 upgrade
and Upgrade/Connection headers. Confirm that the client uses ws: for
HTTP and wss: for HTTPS, and that the relay is running at the configured
endpoint.
When inspecting derived Automerge state, materialize the proxy before using object enumeration:
const plain = JSON.parse(JSON.stringify(state));
const values = Object.values(plain.tokens);
If a build fails, first run the exact entry/output command again and check the
entry imports and installed dependencies. The WASM is expected to be in the
bundle; a missing separate .wasm request is normal for this build path.