Dune Browser WASM Troubleshooting
When To Use
- Browser app fails during startup in src/DuneTools/DuneTools.Browser.
- Runtime shows 404 for native libraries or framework artifacts.
- SkiaSharp or HarfBuzz initialization fails at runtime.
- A change to browser packaging, runtime config, or publish output breaks loading.
Procedure
Confirm failure details first. Collect the exact error text, failing URL, and whether the issue appears in local run, publish output, or deployed hosting.
Verify browser project configuration. Check src/DuneTools/DuneTools.Browser/DuneTools.Browser.csproj and confirm:
- Target framework is net10.0-browser.
- WasmBuildNative is enabled.
- Project reference to src/DuneTools/DuneTools/DuneTools.csproj remains intact.
Verify dependency consistency. Confirm Avalonia package versions remain synchronized in src/DuneTools/Directory.Packages.props.
Verify local tooling. If native WASM build behavior looks wrong, ensure wasm-tools workload is installed and current.
Reproduce with minimal commands. Use a focused build or publish command for src/DuneTools/DuneTools.Browser/DuneTools.Browser.csproj, then inspect output artifacts under publish directories and framework payload files.
Fix the smallest root cause. Prioritize targeted changes in browser project config or package/version alignment. Avoid broad refactors.
Validate end-to-end. Confirm the app starts, no missing asset requests remain, and browser console no longer reports initialization/type failures.
Output Checklist
- Root cause summary.
- Exact files changed.
- Validation commands run.
- Remaining risk, if any.
Source: OpenRakis/OpenRakis — distributed by TomeVault.