Make programs using Odin + Sokol that work on the web!

Live example: https://zylinski.se/odin-sokol-web/

This assumes you have a recent Odin compiler installed.

1. Install emscripten
2. Clone this repository
3. Run build_web.bat or build_web.sh depending on platform (you may need to open the script and modify the path to emscripten)

Web build is in build/web

There is also a build_desktop.bat/sh that makes a desktop version of your program.

1. The contents of source is compiled with Odin compiler using js_wasm32 target. It is compiled in obj build mode. This means that no libraries are linked. That instead happens in step (3).
2. The odin.js environment is copied from <odin>/core/sys/wasm/js/odin.js to build/web
3. The emscripten compiler is run. It is fed the output of our Odin compilation as well as the Sokol library files. It is also fed a template HTML file that is used as basis for the final index.html file. The resulting WASM files and are written to build/web

Open the resulting build/web/index.html, to see how it starts up the main proc in our Odin code.

• Any C library you use in the Odin code needs to be manually linked into emcc.
• If you get compile errors related to vendor:libc when using any WASM library, then you'll need to remove the import "vendor:libc" line from that library. Some libraries, such as vendor:box2d and vendor:stb/image use vendor:libc to remove the need for emscripten. However, this breaks those libs when used in combination with emscripten.

• Replace the contents of folder source/sokol with this: https://github.com/floooh/sokol-odin/tree/main/sokol -- Afterwards, run the scripts inside the source/sokol folder to compile the libs.
• Replace the contents of folder sokol-shdc with this: https://github.com/floooh/sokol-tools-bin/tree/master/bin

You probably have a global variable that allocates dynamic memory. Move that allocation into the game's init or main proc. This could also happen if initialize dynamic arrays or maps in the global file scope, like so:

arr := [dynamic]int { 2, 3, 4 }

In that case you can declare it and do the initialization in the init proc instead:

arr: [dynamic]int

main :: proc() {
  arr = { 2, 3, 4 }

  // bla bla
}

This happens because the context hasn't been initialized with the correct allocator yet.

Try modifying the build_web script and add these flags where it runs emcc:

-sALLOW_MEMORY_GROWTH=1 -sINITIAL_HEAP=16777216 -sSTACK_SIZE=65536

The numbers above are the default values, try bigger ones and see if it helps.

You might be missing the assets folder. It must have at least a single file inside it. You can also remove the --preload assets from the build script.