Wails v3.0.0-beta.8
- Add documentation URL generation to automatic changelog entries in PR by @taliesin-ai
- Add Streams: bidirectional byte streams between Go and JavaScript with the WebSocket programming model and no listening socket. Declare a stream in Go with
app.HandleStream(name, handler)and connect from the frontend withStream(name), which returns aWebSocket-shaped object. Go→JS is carried by one held poll per window over the asset server, JS→Go by a normal POST; nothing binds a TCP port and nothing goes throughevaluateJavaScript. In server builds (-tags server) the same handler is served over a real WebSocket instead, so application code is identical across builds. by @leaanthony - Move mailbox changelog entry to Unreleased in PR by @leaanthony
- Update docs sidebar autogeneration and blog author type derivation in PR by @leaanthony
- WebView2 initialization uses a deadline and message pump in PR by @leaanthony
- WebView2 cookie test skips in CI unless opt-in and locks execution to current OS thread in PR by @leaanthony
- Windows menu builders restore command IDs for submenu parent items in PR by @gilad-ch
- Align the official cross-compilation image with the GTK 4.14+ Linux support baseline (#5928)
- Configure iOS Xcode project to retain inherited linker flags and add -ObjC in PR by @mortenolsrud
- Fix excessive TCP connection churn in the
wails3 devasset proxy on large frontends, which could exhaust the host's ephemeral ports and make unrelated processes fail withEADDRNOTAVAIL - Queue per-window event JavaScript for ordered dispatch and backpressure in PR by @leaanthony
- Remove the desktop binary release pipeline: v3 releases are tag-only and the
wails3CLI is installed withgo install. Deletesrelease-v3.ymland the nightly step that dispatched it in PR by @leaanthony
🤖 This is an automated nightly release generated from the latest changes on master.
Installation:
go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-beta.8
Wails v3.0.0-beta.7
- Add macOS autoplay preference to disable user action requirement for media playback in PR by @Eyalm321
- Move mailbox changelog entry to Unreleased in PR by @leaanthony
- macOS zoom animation uses CADisplayLink or NSTimer for smoother performance in PR by @savely-krasovsky
- Configure iOS Xcode project to retain inherited linker flags and add -ObjC in PR by @mortenolsrud
- Fix excessive TCP connection churn in the
wails3 devasset proxy on large frontends, which could exhaust the host's ephemeral ports and make unrelated processes fail withEADDRNOTAVAIL - Queue per-window event JavaScript for ordered dispatch and backpressure in PR by @leaanthony
🤖 This is an automated nightly release generated from the latest changes on master.
Installation:
go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-beta.7
Wails v3.0.0-beta.6
- Implement bounded host-side storage for oversized events and ordered JavaScript delivery in PR by @leaanthony
- Implement macOS Dock bounce for window flashing in PR by @julianstorer
- Asset server preserves content-type sniffer errors and unwritten prefixes during flushing in PR by @leaanthony
- Prevent macOS applications from crashing when replacing the application menu from a Wails callback
- Fix unreadable native menus on Windows 10 1809 / Windows Server 2019 (build 17763). The dark-mode uxtheme exports were gated on build 18334, so the app-level dark-mode opt-in never ran on those hosts: the menu background was painted dark but Windows kept drawing menu text in the light theme, leaving dark text on a dark background. The ordinals exist from 17763, so the gate now matches.
- Fix
w32.GetStockObjectcallingGetDeviceCapsinstead ofGetStockObject, which made it return 0 for every stock object. - Improve WebView2 bootstrapper download error handling and reporting in PR by @jannskiee
🤖 This is an automated nightly release generated from the latest changes on master.
Installation:
go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-beta.6
Wails v3.0.0-beta.5
- macOS app activation now respects activation policy for regular apps only in PR by @julianstorer
- Guard uninitialized GTK windows in Linux builds in PR by @julianstorer
- Set explicit opaque background color for Linux WebKit windows before URL load in PR by @julianstorer
🤖 This is an automated nightly release generated from the latest changes on master.
Installation:
go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-beta.5
Wails v3.0.0-beta.4
- Android build tasks default to arm64 and deploy-emulator selects host architecture in PR by @mortenolsrud
- Preserve macOS window zoom state during drag and reduce motion in PR by @leaanthony
- Fix Windows server-mode build by adding
!servertowebview_window_windows_nonclient.gobuild constraint
🤖 This is an automated nightly release generated from the latest changes on master.
Installation:
go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-beta.4
Wails v3.0.0-beta.3
- Document Phase 10 beta verification completion in implementation details in PR by @leaanthony
- Pass window handle to Windows dark-mode API and validate arguments in PR by @leaanthony
- Centralize macOS title-bar button state resolution for frameless windows in PR by @taliesin-ai
- Prevent unreadable native menu text when a Windows application requests dark mode while the Windows app theme is light. The menu now uses the matching light native background until Windows can render dark menu text.
- Fix unreadable native menus on Windows 10 1809 / Windows Server 2019 (build 17763). The dark-mode uxtheme exports were gated on build 18334, so the app-level dark-mode opt-in never ran on those hosts: the menu background was painted dark but Windows kept drawing menu text in the light theme, leaving dark text on a dark background. The ordinals exist from 17763, so the gate now matches.
🤖 This is an automated nightly release generated from the latest changes on master.
Installation:
go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-beta.3
Wails v3.0.0-beta.2
- Promote v3 from alpha to beta
- Document system tray smart defaults and popup auto-hide behaviour, with regression coverage for click-handler selection (#5840).
- GitHub updater excludes Windows installer assets by default in PR by @leaanthony
- Add support for rounded, square, and custom radius corners on macOS frameless windows in PR by @leaanthony
- Report live GTK4 window sizes and emit resize, maximise, minimise, and fullscreen state events from the configured surface (#5830).
- Fix Linux WebKit crash when sending Blob or FormData in fetch requests in PR by @taliesin-ai
- Fetch shim passes undefined for missing Blob/FormData headers in PR by @leaanthony
🤖 This is an automated nightly release generated from the latest changes on master.
Installation:
go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-beta.2
Wails v3.0.0-beta.0
v3.0.0-beta.0 is the first Wails v3 beta release. The desktop API is stable, but this is still a prerelease: test thoroughly before using it in a critical production deployment and report reproducible issues so we can finish v3 well.
- Explicit application and window APIs, with first-class multi-window support.
- Go services and static source analysis for richer generated TypeScript bindings that preserve comments and meaningful parameter names.
- The foundation for richer, installable plugins: services can package frontend assets and scripts alongside their backend API.
- A visible Taskfile-based build system, server builds, and experimental iOS and Android support.
- Guided environment setup with
wails3 setup, followed by project creation withwails3 init.
Read the full announcement: Wails v3 Beta: a new foundation for Go desktop applications.
go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-beta.0
wails3 setup
wails3 init
Wails v2 remains the current stable release. The supported v3 beta migration path is the v2-to-v3 migration guide. Port deliberately, test the result, and keep your v2 application in place until the new one is ready.
- Read the v3 documentation, including the beta status and compatibility promise.
- Report reproducible bugs with the output of
wails3 doctorand a minimal example where possible. - Propose new public capabilities through a draft WEP (Wails Enhancement Proposal) PR rather than a feature-request issue.
- Join the conversation on Discord or the relaunched Wails subreddit.
Release binaries are provided for macOS (Intel, Apple Silicon, and universal), Linux (amd64 and arm64), and Windows (amd64). Verify downloaded binaries against the included SHA256SUMS file.
The macOS binaries in this beta are intentionally unsigned and un-notarized. They may require the usual macOS security override when run directly.