TinyWasm

LLM-Friendly Full-Stack Go Framework — Build complete web applications using only Go + WebAssembly, with minimal JavaScript. TinyWasm is a TUI-based development environment that acts as an intelligent intermediary between you, your LLM assistant, and your application.

Source code is maintained privately. This repository distributes official binaries.

---

Installation

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/tinywasm/installer/main/scripts/install.sh | bash

Windows (PowerShell as Admin)

irm https://raw.githubusercontent.com/tinywasm/installer/main/scripts/install.ps1 | iex

The installer downloads the latest binary for your platform, verifies its SHA256 checksum, and places it on your PATH. Go and TinyGo are installed automatically — no prerequisites needed.

Update

tinywasm --update

Manual download (fallback)

Pre-compiled binaries for Linux (amd64/arm64), macOS (arm64/amd64) and Windows (amd64) are available on the Releases page.

---

Quick start

mkdir myapp && cd myapp
tinywasm

TinyWasm will:

1. Scaffold the project structure if it's a new directory
2. Start the development server on https://localhost:6060
3. Launch the TUI with live logs and component status
4. Open Chrome with auto-reload enabled
5. Start the MCP server on http://localhost:3030/mcp for LLM integration

---

Key features

Feature	Description
MCP server	AI assistants can see your UI, read logs, and control compilation
Three WASM modes	L (Go std ~2MB), M (TinyGo debug ~500KB), S (TinyGo release ~200KB)
Hot reload	Backend, WASM, assets, and browser — all automatic
TUI control center	Real-time status and logs for all components
Zero config	Project structure is the configuration

---

MCP server

The MCP daemon starts automatically and integrates with your IDE:

tinywasm -mcp     # start global daemon (MCP + SSE on :3030)
tinywasm          # start TUI client (connects to daemon)

IDE	Config file
VS Code	~/.config/Code/User/mcp.json
Claude Code	~/.claude.json → mcpServers.tinywasm.url

---

WebAssembly compilation modes

Mode	Compiler	Size	Use case
L	Go standard	~2 MB	Development — full stdlib, fastest iteration
M	TinyGo debug	~500 KB	Debugging — balanced size and functionality
S	TinyGo release	~200 KB	Production — minimal size, optimized

Switch modes on-the-fly via the TUI or via MCP tool call.

---

Support

• Issues: github.com/tinywasm/app/issues
• Discussions: github.com/tinywasm/app/discussions

---

License

MIT — see LICENSE