wings-build

Building and serving a WINGS app

WINGS components compile to a single WebAssembly binary loaded by a tiny JS shim. A WASM page cannot be opened from file:// — it must be served over HTTP with the correct MIME type.

Project layout

myapp/
  go.mod                 # module myapp
  main.go                # package main, wings.Main(), blank-imports modules
  mod/<name>/<name>.{go,html,css}   # your components (see wings-component)
  static/                # web root: index.html + the 3 runtime files
    index.html
    prana_helper.js
    wasm_exec.js
    wings.wasm           # build output

Set it up:

go mod init myapp
go get github.com/luisfurquim/wings

main.go — one per app; every component is registered by blank-importing its package:

//go:build js && wasm
package main

import (
	"github.com/luisfurquim/wings"
	_ "myapp/mod/hello"            // each module
	_ "github.com/luisfurquim/wings/wi18n" // optional: runtime i18n (see wings-i18n)
)

func main() { wings.Main() }

The two runtime helper files

Copy both into your web root next to the wasm:

W=$(go list -m -f '{{.Dir}}' github.com/luisfurquim/wings)
cp "$W/prana_helper.js" static/
# Go 1.24+: lib/wasm/ ; older: misc/wasm/
cp "$(go env GOROOT)/lib/wasm/wasm_exec.js" static/ 2>/dev/null \
  || cp "$(go env GOROOT)/misc/wasm/wasm_exec.js" static/

static/index.html loads them and streams the wasm:

<!DOCTYPE html>
<html>
<head>
  <script src="prana_helper.js"></script>
  <script src="wasm_exec.js"></script>
  <script>
    const go = new Go();
    WebAssembly.instantiateStreaming(fetch("wings.wasm"), go.importObject)
      .then(r => go.run(r.instance)).catch(console.error);
  </script>
</head>
<body>
  <hello-world></hello-world>   <!-- your custom element tag -->
</body>
</html>

Build and serve

GOOS=js GOARCH=wasm go build -o static/wings.wasm .

Then serve static/ over HTTP with .wasm as application/wasm (any static server that sets that MIME; a tiny Go server works — see the README Quick Start). Opening index.html from disk will not work.