Hugo Nijhuis
260f46e814
- Add explicit mkdir -p public before wasm_exec.js copy - Specify to save app code as main.go - Specify to save server code as server.go Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
113 lines
1.7 KiB
Markdown
113 lines
1.7 KiB
Markdown
# Iris
|
|
|
|
WASM reactive UI framework for Go.
|
|
|
|
## Quickstart
|
|
|
|
Get from zero to a running app in under 5 minutes.
|
|
|
|
### Prerequisites
|
|
|
|
- Go 1.23 or later
|
|
|
|
### Project setup
|
|
|
|
```bash
|
|
mkdir -p public
|
|
cp "$(go env GOROOT)/misc/wasm/wasm_exec.js" ./public/
|
|
```
|
|
|
|
### Create your app
|
|
|
|
Save this as `main.go`:
|
|
|
|
```go
|
|
//go:build js && wasm
|
|
|
|
package main
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"git.flowmade.one/flowmade-one/iris/reactive"
|
|
"git.flowmade.one/flowmade-one/iris/ui"
|
|
)
|
|
|
|
func main() {
|
|
count := reactive.NewSignal(0)
|
|
|
|
view := ui.NewView()
|
|
view.Child(ui.TextFromFunction(func() string {
|
|
return fmt.Sprintf("Count: %d", count.Get())
|
|
}))
|
|
view.Child(ui.Button(func() {
|
|
count.Set(count.Get() + 1)
|
|
}, ui.TextFromString("Click me")))
|
|
|
|
ui.NewApp(view)
|
|
|
|
// Keep the program running
|
|
select {}
|
|
}
|
|
```
|
|
|
|
### Create the HTML host
|
|
|
|
Create `public/index.html`:
|
|
|
|
```html
|
|
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<title>Iris App</title>
|
|
<script src="wasm_exec.js"></script>
|
|
<script>
|
|
const go = new Go();
|
|
WebAssembly.instantiateStreaming(fetch("app.wasm"), go.importObject).then((result) => {
|
|
go.run(result.instance);
|
|
});
|
|
</script>
|
|
</head>
|
|
<body></body>
|
|
</html>
|
|
```
|
|
|
|
### Build
|
|
|
|
```bash
|
|
GOOS=js GOARCH=wasm go build -o public/app.wasm ./main.go
|
|
```
|
|
|
|
### Run
|
|
|
|
Save this as `server.go`:
|
|
|
|
```go
|
|
package main
|
|
|
|
import (
|
|
"net/http"
|
|
|
|
"git.flowmade.one/flowmade-one/iris/host"
|
|
)
|
|
|
|
func main() {
|
|
server := host.New("public", "index.html")
|
|
http.ListenAndServe(":8080", server)
|
|
}
|
|
```
|
|
|
|
Then run:
|
|
|
|
```bash
|
|
go run server.go
|
|
```
|
|
|
|
### Expected output
|
|
|
|
Open http://localhost:8080 in your browser. You should see:
|
|
- A "Count: 0" text
|
|
- A "Click me" button
|
|
- Clicking the button increments the count reactively
|