Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Addedfor new features.Changedfor changes in existing functionality.Deprecatedfor soon-to-be removed features.Removedfor now removed features.Fixedfor any bug fixes.Securityin case of vulnerabilities.
[Unreleased]โ
Fixedโ
- Fixed
wails initto prevent initialization in non-empty directories when using the-dflag, avoiding accidental data loss#4940by@leaanthony - Fixed missing
EventsOffAllin runtime templates for all frontend frameworks #4883 by @narcilee7 - Fixed Linux crash on panic in JS-bound Go methods due to WebKit overriding signal handlers #3965 by @leaanthony
- Fixed code block range in "How Does It Work?" documentation #4884 by @msal4
- Fixed WebView crash on macOS 26 (Tahoe) during rapid UI updates #4592 by @leaanthony
- Updated menu reference docs with complete imports by @agilgur5 in #4727 and #4742
- Fixed menu reference syntax by @agilgur5 in #4726
- Fixed indentation in Application Development guide by @agilgur5 in #4730
- Updated Application Development guide to show imports in the
app.gosnippets by @agilgur5 in #4731 - Fixed link to CoC in Community Guide when there was a trailing slash by @agilgur5 in #4732
- Fixed indentation in "How does it work?" page by @agilgur5 in #4733
- Updated wails installation documentation to allow copying the
install wailscommand with one click by @tilak999 in #4692 - Remove ioutl.Discard and replace it with io.Discard by @xjh22222228 in #4877
v2.11.0 - 2025-11-08โ
Addedโ
- Add origin verification for bindings by @APshenkin in PR
- Configure Vite timeout by @leaanthony in PR
- Added
ContentProtectionoption to allow hiding the application window from screen sharing software #4241 by @Taiterbase - Added
build:tagsto project specification for automatically adding compilation tags by @symball in PR - Support for binding generics in PR by @ktsivkov
- Add universal link support for macOS by @APshenkin in PR
- Notifications API in PR by @popaprozac
Fixedโ
- Added url validation for BrowserOpenURL by @APshenkin in PR
- Fixed C compilation error in onWayland on Linux due to declaration after label #4446 by @jaesung9507
- Use computed style when adding 'wails-drop-target-active' PR by @riannucci
- Fixed initialisation templates to the correct Go version PR by @Xelus22
- Fixed panic when adding menuroles on Linux #4558 by @jaesung9507
- Fixed generated enums ordering #4664 by @rprtr258.
- Fixed Discord badge in README by @sharkmu in PR
- Fixed HTML DnD by @leaanthony
v2.10.2 - 2025-07-06โ
Fixedโ
- Fixed Window size issues on Wayland PR by @lyimmi
- Fixed SaveFileDialog cancellation result PR by @FrancescoLuzzi
- Added EventsOffAll to
windows.runtime, fixes #3136 PR by @FrancescoLuzzi - Fixed issues with hot reloading and quitting not working on Windows PR by @hkere
Changedโ
- Updated recommendation for Svelte router in #4085 by @benmccann
- Updated documentation to clarify
WebviewGpuPolicydefault behavior on Linux in #4162 by @brianetaveras - Updated documentation to display the correct copyright year in #4243 by @nnashwin
Addedโ
- Added DLLSearchPaths option to control DLL search paths on Windows in #4207 by @ansxuman
- Added "Branding" section to
wails doctorto correctly identify Windows 11 #3891 by @ronen25 - Added
-skipembedcreateflag to build and dev command to improve compile and recompile speed #4143 by @josStorer - Added
DisablePanicRecoveryoption to allow handle panics manually #4136 by @APshenkin - Added community template wails-htmx-tailwind-daisyui-template. Added by @ltcovalt in PR
Fixedโ
- Fixed build fails when cross compiling on Linux for Windows #4262 by @rynsf
- Fixed typescript generation of maps with key of array of structs by @joshuapare in #4209
- Fixed -m build flag for dev command not working when recompiling in #4141 by @josStorer
- Fixed window restoration behavior after minimization by @superDingda in #4109
- Fixed excessive console logging after updating to v2.10.1 by @superDingda in #4111
- Fixed incorrect Webview2 reg key in HKCU path by @leaanthony.
- Fixed long WebSocket messages being truncated in
wails devby @superDingda in #4211
v2.10.1 - 2025-02-24โ
Fixedโ
- Fixed listenerOff issue by @leaanthony.
- Fixed logger issue by @meeehdi-dev.
- Fixed issues building with
darwin/universaltarget by @leaanthony.
v2.10 - 2025-02-15โ
Addedโ
- Added option to set window class name on Windows. Added in PR by @APshenkin
Fixedโ
- Fixed dev mode logging bug by @attperac in #3972
- Fixed
reloaddirswails.json config options by @atterpac in #4005 - Fixed cross compilation failed with CGO PR by @fcying
- Using go-webview2 v0.1.17 to fix native webview2loader issue, by @leaanthony
- Fixed example for macOS menu by @takuyahara in PR
- Fixed typo by @takuyahara in PR
- Fixed incorrect TS definition of
WindowSetSizeby @leaanthony - Ensure showHiddenFiles works with directory dialog by @leaanthony in PR
- chore: fix some comments in PR by @lvyaoting
- [windows] Fixed frameless window flickering when minimizing/restoring by preventing unnecessary redraws #3951
- Fixed failed models.ts build due to non-json-encodable Go types PR by @pbnjay
- Fixed more binding and typescript export bugs PR by @pbnjay
- Fixed Dispatcher.ProcessMessage crash process instead of return error PR #4015 by @ronaldinho_x86
- Fixed Windows SaveDialog crash by @leaanthony
- Fixed
buildvcserrors by @leaanthony - Fixed updating menus on MacOS by @stffabi
- Fixed a build error on macOS that occurred when the
outputfilenameandnamefields in wails.json were different. Fixed in PR by @nickisworking
Changedโ
- Removed documentation references for 'The default module name in go.mod is "changeme". You should change this to something more appropriate.' as it appears to be no longer relevant.
- Update script in Mac App Store guide to support app names containing spaces by @cristianrgreco
- Allow to specify macos-min-version externally. Implemented by @APshenkin in PR
- Updated installation docs for latest linux os version and libwebkit issue PR by @pratikmota
v2.9.3 - 2025-02-13โ
Addedโ
- Go 1.24 support by @leaanthony
Fixedโ
- Now using
-buildvcs=falsebuild tag by default to removeerror obtaining VCS status: exit status 128errors by @leaanthony
v2.9.2 - 2024-09-18โ
Fixedโ
- Fixed CGO memory issue on Darwin by @leaanthony in PR
- Fixed an error that occurred when an author name contains a string that is not suitable for JSON. Fixed by @taiseiotsuka in PR
- Fixed MacOS build to use
outputfilenamefrom wails.json. #3200 - Fixed doctor command not finding pkg-config on Solus. PR #3670 by @ianmjones
- Fixed binding for struct fields that were exported but had no json tags. PR #3678
- Fixed file drop events on Windows in PR by @FrancescoLuzzi
- Modified
ZoomFactorandIsZoomControlEnabledoptions to be Windows-only options in PR#3644 by @levinit - Added nil check for Drag-n-Drop on Windows. Fixed by in PR by @leaanthony based on the suggestion by @Alpa-1 in #3596.
- Fixed typos in various .mdx files. PR #3628 by @deining
- Fixed
notifyListeners()race condition when terminated mid-emission PR by @mrf345 - Fixed dialogs in Windows when using Go 1.23 in PR by @leaanthony
- More syscall fixes for Go 1.23 support in PR by @leaanthony
- Fixed drag and drop missing cursor icon PR by @mrf345
Changedโ
- Modified docs to reflect the correct password syntax for the
gon-sign.jsonfile PR by @ignasbernotas
v2.9.1 - 2024-06-18โ
Fixedโ
- Fixed build issues on Linux for some glibc versions. Fixed in PR by @leaanthony.
v2.9.0 - 2024-06-16โ
Addedโ
- Added Drag & Drop (files or folders) support for Windows and Linux. Added by @lyimmi in PR. Based on the work of @ayatkyo for Windows in PR.
- Added Drag & Drop (files or folders) support for macOS. Added by @APshenkin in PR.
- Support for compiling with
libwebkit2gtk-4.1instead of4.0to support latest Ubuntu release by atterpac in #3465 - Extended Routing guide with Svelte example by @stanislav-zeman in #3481
- Unit test for fix #3476 by gjergj in #3485
- German Readme Translation by Zeiichenfolge in #3483
- Added support generating bindings for structs without fields. Added by gjergj in PR
Changedโ
- Updated several broken links in the "How Does It Work?" page on the website. Changed by @oguz-yilmaz in PR #3469
- Upgraded Go version in CI to 1.22 by @leaanthony in #3473.
Fixedโ
- Fix Drag & Drop JS runtime. Added by @jakubpeleska, provided by Beam Transfer in PR.
- Fixed optional type generation where an extra
?would be placed inside the field name instead of outside the name"field?"?vs"field"?. Fixed by @atterpac in #3476 - Fixed an issue where
WindowGetPositionandWindowSetPositionvalues were inconsistent on MacOS. Fixed by @cenan - Fix scoop command usage typo. Fixed by @fieu in #3501
- Fixed macOS single instance lock reset after some time. Fixed by @APshenkin in PR
v2.8.2 - 2024-05-08โ
Breaking Changeโ
- The
-noPackageflag was misnamed and is being renamed tonopackageto match the other flags. Changed by @leaanthony in PR.
Addedโ
- Added support for proxying assets requests to an external server. Added by @leaanthony in PR
Fixedโ
- Fixed an issue with missing icon for Windows. Fixed by @APshenkin
v2.8.1 - 2024-04-11โ
Addedโ
- Added docs help to indicate that in IDE options you can choose between vscode and goland. Added by @DiegPS in PR
- Added docs to help fix NixOs/Wayland font-size css issue. Added by @atterpac in PR
- Added -m (skip
go mod tidy) flag to dev command by @te5se in PR - Added mac option
DisableZoomto remove zoom button. Added by @wizzymore in PR
Fixedโ
- Fixed an issue where embed directives with patterned paths would create illegal directories. Changed by @twonull in PR
- Fixed an issue where certain calls to createFrom in TypeScript would fail. Changed by @twonull in PR
- Fixed some typos in comments. Changed by @reallylowest in PR
- Fixed an issue where the destination file was not properly closed after copying. Changed by @testwill in PR
- Fixed an issue where
xattrcalls were not working. Fixed by @leaanthony - Warn in the documentation that the fixed version of the WebView 2 Runtime must be extracted before use. Documented by @ALizarazoTellez in PR.
Changedโ
- Changed Create a project with changing the default name to the projectโs name. Changed by @Twacqwq in PR
v2.8.0 - 2024-02-08โ
Addedโ
- Added windows options supports
DisablePinchZoomconfiguration. Added by @tuuzed in PR - Add Apple Silicon hardware detection to
wails doctor. Changed by @almas1992 in PR - Remove quarantine attribute on macOS binaries. Changed by @leaanthony in PR
- Added documentation for a common GStreamer error on Linux systems. Changed by @mkwsnyder in PR
- Added documentation on explicity example of importing JS runtime. Changed by @danawoodman in PR
- Add dock icon right-click exit handling by @almas1992 in PR
Fixedโ
- Fixed vue-ts template build error. Fixed by @atterpac in PR
- Docs for IsZoomControlEnabled and ZoomFactor. Fixed by @leaanthony in PR
- Fixed
-compilerflag forwails build,wails devandwails generate module. Fixed in PR by @xtrafrancyz - Fixed uninitialized
SecondInstanceData.WorkingDirectoryon linux and windows (#3154). - Fixed React Routing documentation add 'Routes' and 'Route'. Fixed by @doracpphp in PR
- Fixed save file dialog not appending file extension automatically on Windows by @almas1992 in PR
- Fixed compatibility for wails cli being built with go 1.22 and later. Fixed by @stffabi in PR
- Fixed documentation for Window API return types. Fixed by @jangler in PR
v2.7.1 - 2023-12-10โ
Fixedโ
- Segfault in
wails doctorwhen GPU device information is not provided. Thanks to @atterpac for the fix (#3108). - Fixed building on macOS 11. Updated other build guards. Fixed in #3111 by @leaanthony.
Changedโ
- Go 1.20 is now the minimum supported Go version.
v2.7.0 - 2023-12-09โ
Addedโ
- Update the description of
ZoomFactorandIsZoomControlEnabledattributes in the document. Added by @biuaxia in PR - Added Single Instance Lock support with passing arguments to first instance. Added by @APshenkin in PR
- Added support for enabling/disabling swipe gestures for Windows WebView2. Added by @leaanthony in PR
- When building with
-devtoolsflag, CMD/CTRL+SHIFT+F12 can be used to open the devtools. Added by @leaanthony in PR โ Added file association support for macOS and Windows. Added by @APshenkin in PR - Added support for setting some of the Webview preferences,
textInteractionEnabledandtabFocusesLinkson Mac. Added by @fkhadra in PR - Added support for enabling/disabling fullscreen of the Webview on Mac. Added by @fkhadra in PR
- Added French README.fr.md page. Added by @nejos97 in PR
- New task created for linting v2
task v2:lint. Workflow updated to run the task. Added by @mikeee in PR - Added new community template wails-htmx-templ-chi-tailwind. Added by @pylotlight in PR
- Added CPU/GPU/Memory detection for
wails doctor. Added by @leaanthony in #d51268b8d0680430f3a614775b13e6cd2b906d1c - The AssetServer now injects the runtime/IPC into all index html files and into all html files returned when requesting a folder path. Added by @stffabi in PR
- Added Custom Protocol Schemes associations support for macOS and Windows. Added by @APshenkin in PR โ Added support for TS interfaces generation as an option. Add support for Enums in TS types. Added by @APshenkin in PR
Changedโ
- AssetServer requests are now processed asynchronously without blocking the main thread on Windows. Changed by @stffabi in PR
- AssetServer requests are now processed concurrently by spawning a goroutine per request. Changed by @stffabi in PR
- Now building with
-devtoolsflag doesn't enable the default context-menu. Changed by @mmghv in PR - Change Window Level. Changed by @almas1992 in PR
Fixedโ
- Fixed typo on docs/reference/options page. Added by @pylotlight in PR
- Fixed issue with npm being called npm20 on openSUSE-Tumbleweed. Fixed by @TuffenDuffen in PR
- Fixed memory corruption on Windows when using accelerator keys. Fixed by @stffabi in PR
- Fixed binding mapping for obfuscated build, when binding are in different structs. Fixed by @APshenkin in PR
- Fixed issue with obfuscation settings in wails.json. Fixed by @APshenkin in PR
v2.6.0 - 2023-09-06โ
Breaking Changesโ
- AssetServer RequestURI and URL are now RFC and Go Docs compliant for server requests. This means Scheme, Host and Fragments are not provided anymore. Changed by @stffabi in PR
Fixedโ
- Avoid app crashing when the Linux GTK key is empty. Fixed by @aminya in PR
- Fix issue where app would exit before main() on linux if $DISPLAY env var was not set. Fixed by @phildrip in PR
- Fixed a race condition when positioning the window on Linux. Added by @lyimmi in PR
- Fixed
SetBackgroundColourso it sets the window's background color to reduce resize flickering on Linux. Added by @lyimmi in PR - Fixed disable window resize option and wrong initial window size when its enabled. Added by @lyimmi in PR
- Fixed build hook command parsing. Added by @smac89 in PR
- Fixed filesystem watcher from filtering top level project directory if binary name is included in .gitignore. Added by @haukened in PR #2869
- Fixed
-reloaddirflag to watch additional directories (non-recursively). @haukened in PR #2871 - Fixed support for Go 1.21
go.modfiles. Fixed by @stffabi in PR
Addedโ
- Added correct NodeJS and Docker package names for DNF package manager of Fedora 38. Added by @aranggitoar in PR
- Added
-devtoolsproduction build flag. Added by @mmghv in PR - Added
EnableDefaultContextMenuoption to allow enabling the browser's default context-menu in production . Added by @mmghv in PR - Added smart functionality for the default context-menu in production with CSS styles to control it. Added by @mmghv in PR
- Added custom error formatting to allow passing structured errors back to the frontend.
- Added sveltekit.mdx guide. Added by @figuerom16 in PR
- Added ProgramName option to linux.Options. Added by @lyimmi in PR
- Added new community template wails-sveltekit-ts. Added by @haukened in PR
- Added support for retrieving the logical and physical screen size in the screen api. Added by @stffabi in PR
- Added new community template wails-sveltekit-tailwind. Added by @pylotlight in PR
- Added support for print dialogs. Added by @aangelisc in PR
- Added new
wails dev -nogorebuildflag to prevent restarts on back end file changes. @haukened in PR #2870 - Added a guide to describe a cross-platform build using GitHub Actions. Added by @dennypenta in PR
Changedโ
- Now uses new
go-webview2module. Added by @leaanthony in PR. - Changed styling of
doctorcommand. Changed by @MarvinJWendt in PR - Enable HiDPI option by default in windows nsis installer. Changed by @5aaee9 in PR
- Now debug builds include the un-minified version of the runtime JS with source maps . Changed by @mmghv in PR