菜单
Wails v2 Go desktop apps with web frontend. This skill should be used when scaffolding, binding Go to JS, configuring options, building cross-platform, or debugging webkit2gtk/WebView2 rendering.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | wails |
| description | Wails v2 Go desktop apps with web frontend. This skill should be used when scaffolding, binding Go to JS, configuring options, building cross-platform, or debugging webkit2gtk/WebView2 rendering. |
| last_updated | "2026-04-18T00:00:00.000Z" |
| wails_version | v2.9 |
| source | https://github.com/wailsapp/wails/tree/master/website/docs |
# Install CLI
go install github.com/wailsapp/wails/v2/cmd/wails@latest
# Check dependencies
wails doctor
# Create project (default: svelte)
wails init -n myapp -t svelte-ts
# Development with hot-reload
cd myapp && wails dev
# Production build
wails build
┌─────────────────────────────────────┐
│ Desktop Window │
│ ┌───────────────────────────────┐ │
│ │ WebView (webkit2gtk/WebView2)│ │
│ │ ┌─────────────────────────┐ │ │
│ │ │ Frontend (Svelte/React │ │ │
│ │ │ /Vue/Preact/Lit/Vanilla│ │ │
│ │ └──────────┬──────────────┘ │ │
│ └──────────────┼────────────────┘ │
│ │ IPC (JSON-RPC) │
│ ┌──────────────┴────────────────┐ │
│ │ Go Backend │ │
│ │ - Bound methods → JS funcs │ │
│ │ - Runtime API │ │
│ │ - Lifecycle callbacks │ │
│ └───────────────────────────────┘ │
└─────────────────────────────────────┘
Method binding: Go structs with exported methods → wails.Bind() → auto-generated TypeScript in frontend/wailsjs/. Frontend calls Go methods as async JS functions. Structs used as params/returns get TS models generated.
Runtime API: runtime package provides window control, events (emit/on), dialogs (open/save/message), clipboard, screen info, notifications, drag-drop, browser open, environment, log, menu updates.
Lifecycle callbacks: OnStartup(ctx) → OnDomReady(ctx) → app runs → OnBeforeClose(ctx) bool → OnShutdown(ctx). Context from OnStartup used for runtime calls.
myapp/
├── main.go # Entry point, wails.Run() with options
├── app.go # App struct with bound methods
├── wails.json # Project config (name, frontend:build/install, author)
├── go.mod
├── frontend/
│ ├── src/ # Frontend source (framework-specific)
│ ├── index.html
│ ├── package.json
│ └── wailsjs/ # Auto-generated bindings (DO NOT EDIT)
│ ├── go/ # Go method wrappers as JS
│ └── runtime/ # Runtime API TS definitions
├── build/
│ ├── appicon.png # App icon
│ ├── darwin/ # macOS-specific (Info.plist)
│ ├── windows/ # Windows-specific (wails.exe.manifest, NSIS config)
│ └── bin/ # Build output
wails.Run(&options.App{
Title: "My App",
Width: 1024,
Height: 768,
MinWidth: 400,
MinHeight: 300,
Frameless: false,
StartHidden: false,
AlwaysOnTop: false,
BackgroundColour: &options.RGBA{R: 27, G: 38, B: 54, A: 1},
OnStartup: app.startup,
OnShutdown: app.shutdown,
OnDomReady: app.domReady,
OnBeforeClose: app.beforeClose,
Bind: []interface{}{app},
// Platform-specific
Windows: &windows.Options{},
Mac: &mac.Options{},
Linux: &linux.Options{},
})
{
"name": "myapp",
"outputfilename": "myapp",
"frontend:install": "npm install",
"frontend:build": "npm run build",
"frontend:dev:watcher": "npm run dev",
"frontend:dev:serverUrl": "auto",
"author": { "name": "Dev", "email": "dev@example.com" }
}
| Command | Purpose |
|---|---|
wails init -n NAME -t TEMPLATE | Create new project |
wails dev | Dev mode with hot-reload |
wails build | Production build |
wails build -nsis | Windows NSIS installer |
wails build -platform darwin/universal | macOS universal binary |
wails build -tags webkit2_41 | Ubuntu 24.04+ webkit support |
wails generate module | Regenerate frontend bindings |
wails doctor | Check system dependencies |
Reviews code comments across languages before a PR opens. Use when finishing a development branch, before merging, or when a pr create was blocked pending comment review.
Create, promote, categorize, and validate skills for the kettleofskills marketplace. Use when syncing dotfiles skills into the marketplace, adding skills, assigning categories, or preparing a release.
Docker builds, Compose, and Docker-in-Docker for CI. Use when writing Dockerfiles, optimizing build times, multi-stage builds, BuildKit cache mounts, docker-compose.yml, or CI/CD pipelines (GitHub/GitLab/Forgejo Actions) — including docker-in-docker (dind) runners, rootless dind, bind-mount-vs-build-context confusion, and "mkdir <path>: permission denied" mount failures. Covers layer ordering, dependency caching, .dockerignore, multi-stage, BuildKit, Compose, and dind mount patterns.
Create or update Claude skills. Use for new skills, skill references, skill scripts, optimizing existing skills, extending Claude's capabilities.
Build Go terminal UIs (TUIs) and CLIs with charmbracelet — Bubble Tea runtime, Lip Gloss styling, Bubbles components, Glamour markdown, Harmonica animation, BubbleZone mouse. For any bubbletea TUI.
Bun SQL-first ORM for Go (uptrace/bun). Use for PostgreSQL/SQLite setup, bun.BaseModel struct tags, query builder CRUD, relations, migrations, fixtures, hooks, transactions, and soft deletes.