Skip to main content

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.

  • Added for new features.
  • Changed for changes in existing functionality.
  • Deprecated for soon-to-be removed features.
  • Removed for now removed features.
  • Fixed for any bug fixes.
  • Security in case of vulnerabilities.

[Unreleased]​

  • 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 DisableZoom to remove zoom button. Added by @wizzymore in PR

v2.8.0 - 2024-02-08​

Added​

  • Added windows options supports DisablePinchZoom configuration. 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 -compiler flag for wails build, wails dev and wails generate module. Fixed in PR by @xtrafrancyz
  • Fixed uninitialized SecondInstanceData.WorkingDirectory on linux and windows (#3154).
  • 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

v2.7.1 - 2023-12-10​

Fixed​

  • Segfault in wails doctor when 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 ZoomFactor and IsZoomControlEnabled attributes 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 -devtools flag, 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, textInteractionEnabled and tabFocusesLinks on 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 -devtools flag 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 SetBackgroundColour so 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 -reloaddir flag to watch additional directories (non-recursively). @haukened in PR #2871
  • Fixed support for Go 1.21 go.mod files. 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 -devtools production build flag. Added by @mmghv in PR
  • Added EnableDefaultContextMenu option 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 -nogorebuild flag 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-webview2 module. Added by @leaanthony in PR.
  • Changed styling of doctor command. 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

v2.5.1 - 2023-05-16​

Breaking Changes​

  • The Go WebView2Loader allowed env variable and registry overrides to change the behaviour of WebView2. This is not possible when using the native WebView2Loader with Wails and should not be possible according to PR. Changed by @stffabi in PR
  • wails dev now uses the custom schemes wails:// on macOS and Linux for all Vite versions. This also fixes missing reloads after multiple fast savings on Linux and Windows. Changed by @stffabi in PR

Fixed​

  • Fixed segfaults during fast reloads of requests on macOS. Fixed by @stffabi in PR
  • Fixed devserver on Linux for older WebKit2GTK versions < 2.36. Fixed by @stffabi in PR
  • Fixed devserver on Windows that might have triggered the WebView2 into a hang. Fixed by @stffabi in PR

v2.5.0 - 2023-05-13​

Breaking Changes​

  • wails dev now uses the custom schemes wails:// on macOS and Linux if Vite >= v3.0.0 is used. This makes the dev application consistent in behaviour with the final production application and fixes some long-standing inconsistencies. Changed by @stffabi in PR

Added​

  • Added Nodejs version in wails doctor. Added by @misitebao in PR
  • Added support for WebKit2GTK 2.40+ on Linux. This brings additional features for the AssetServer, like support for HTTP Request Bodies. The app must be compiled with the Go build tag webkit2_40 to activate support for this features. This also bumps the minimum requirement of WebKit2GTK to 2.40 for your app. Added by @stffabi in this PR
  • macOS: Added Window menu role with well known shortcuts "Minimize, Full-Screen and Zoom". Added by @stffabi in PR
  • macOS: Added "Hide, Hide Others, Show All“ to appmenu. Added by @stffabi in PR
  • Windows: Added flag to disable the WebView2 RendererCodeIntegrity checks, please see the comment on the flag for more information. Added by @stffabi in PR
  • Windows: Added handling of WebView2 process crashes, for unrecoverable errors an error message is shown that the app needs to be restarted. If an error occurs that shows a chromium error page, make sure the Window and the WebView2 is visible. Added by @stffabi in PR

Changed​

  • [v3] Typescript model generation using StructDefs from new AST-based parser. Added by @ATenderholt in PR1 and PR2.

Fixed​

  • Fixed console printing in wails generate template. Fixed by @misitebao in PR
  • Fixed unicode encoding of strings for multi-rune characters. Fixed by @joshbuddy in PR
  • Fixed -skipbindings flag in wails dev. Fixed by @stffabi in PR
  • Fixed runtime.MenuUpdateApplicationMenu on macOS. Fixed by @stffabi in PR
  • Fixed add package name for libwebkit/pkg-config and use shell.RunCommandWithENV instead of shell.RunCommand in zypper.go. Fixed by @wgjtyu in PR
  • Make sure to start the CommonFileDialogs on Windows on the Main-Thread. Fixed by @stffabi in PR
  • Fixed generated typescript bindings. Fixed by @dominictwlee in PR
  • Fixed StartHidden option not working on Linux. Fixed by @LGiki in PR

v2.4.1 - 2023-03-20​

Changed​

  • Support single clicks on items with --wails-draggable: drag again on Windows. Changed by @stffabi in PR

Fixed​

  • Fixed panic when using wails dev and the AssetServer tried to log to the logger. Fixed by @stffabi in PR
  • Fixed compatibility with WebView2 Runtime > 110.0.1587.69 which showed a connection refused html page before doing a reload of the frontend. Fixed by @stffabi in PR

v2.4.0 - 2023-03-08​

Added​

  • Added Webview GPU acceleration options for Windows and Linux. Added by @Lyimmi in PR
  • Added EnableFraudulentWebsiteDetection option to opt-in to scan services for fraudulent content, such as malware or phishing attempts. Older releases had the scan services per default activated. Added by @stffabi in PR
  • Allow an AssetServer Middleware to specify the Content-Type of a file served by the Assets fs.FS. Added by @stffabi in PR
  • The AssetServer now detects more mimetypes by extension, e.g. .mjs. Added by @stffabi in PR

Changed​

  • Improved fullscreen mode for frameless window on Windows. Changed by @stffabi in PR, PR and PR
  • On Windows unmaximising a window has no effect anymore when the window is in fullscreen mode, this makes it consistent with e.g. macOS. Changed by @stffabi in PR
  • Frameless resize now sets the cursor on documentElement, otherwise resizing cursor won't be shown outside of the body rectangle. Changed by @stffabi in PR
  • Improved the --wails-draggable experience to be more reactive. Changed by @stffabi in PR
  • NSIS template now installs the shortcuts for all users and not only for the current user. Changed by @stffabi in PR

Fixed​

  • Fixed failing build hooks when build/bin was missing. Fixed by @Lyimmi in PR
  • Fixed fullscreen mode for frameless window on Windows to fully cover the taskbar when changing into fullscreen from maximised state. Fixed by @stffabi in PR
  • Fixed set window background colour on Windows when setting the colour via runtime. Fixed by @stffabi in PR
  • Fixed the showing of a white border around a fullscreen window when DisableWindowIcon is active on Windows. Fixed by @stffabi in PR
  • Fixed the sometimes lagging drag experience with --wails-draggable on Windows. Fixed by @stffabi in PR
  • Fixed applying the default arch to platform flag in wails cli. If only a GOOS has been supplied as platform flag e.g. wails build --platform windows the current architecture wasn't applied and the build failed. Fixed by @stffabi in PR
  • Fixed a segfault on opening the inspector on older macOS versions. Fixed by @stffabi in PR
  • Fixed the macos single architecture builds not respecting an output file name specified with the '-o' flag. Fixed by @gwynforthewyn in PR
  • Fixed undo/redo on macOS. Fixed by @stffabi in PR
  • Fixed Events* runtime functions in JavaScript not returning the function to cancel the watcher. Fixed by @zllovesuki in PR
  • Fixed AppOptions merging defaults when a custom logger is used. Fixed by @stffabi in PR
  • Fixed race condition and missing unlock of mutex in events handling. Fixed by @stffabi in PR

v2.3.0 - 2022-12-29​

Added​

  • Added OpenInspectorOnStartup to debug options to allow opening the WebInspector during startup of the application in debug mode. Added by @stffabi in PR
  • On macOS wails doctor now also shows the version of Xcode installed. Added by @stffabi in PR
  • The AssetServer now supports handling range-requests if the Assets fs.FS provides an io.ReadSeeker. Added by @stffabi in PR
  • Add new property for the wails.json config file - bindings. More information on the new property can be found in the updated schema. Properties prefix and suffix allow you to control the generated TypeScript entity name in the model.ts file. Added by @OlegGulevskyy in PR
  • The WindowSetAlwaysOnTop method is now exposed in the JS runtime. Fixed by @gotid in PR
  • The AssetServer now supports serving the index.html file when requesting a directory. Added by @stffabi in PR
  • Added support for WebKit2GTK 2.36+ on Linux. This brings additional features for the AssetServer, like support for HTTP methods and Headers. The app must be compiled with the Go build tag webkit2_36 to activate support for this features. This also bumps the minimum requirement of WebKit2GTK to 2.36 for your app. Fixed by @stffabi in this PR
  • Added support for file input selection on macOS. Added by @stffabi in PR
  • Added support Request/Response streaming of the AssetServer on macOS. Added by @stffabi in PR
  • Added request path checks for the AssetServer. Added by @stffabi in PR
  • Added new App Store guide. Added by @achhabra2 in PR
  • Added extra libwebkit check for dnf package manager (required for latest Fedora). Fixed by @NullCode1337 in this PR
  • Added new -nomodsync flag to disable the automatic syncing of the go.mod file. Added by @leaanthony in PR
  • Added support for adding prefix and postfix text to generated Typescript classes. Added by @OlegGulevskyy in PR
  • Added reference to NSIS as optional dependency. Added by @acheong08 in PR
  • Added Korean translation for the website. Added by @cybertramp in PR

Fixed​

  • The noreload flag in wails dev wasn't applied. Fixed by @stffabi in this PR
  • build/bin folder was duplicating itself on each reload in wails dev mode. Fixed by @OlegGulevskyy in this PR
  • Prevent a thin white line at the bottom of a frameless window on Windows. Fixed by @stffabi in this PR
  • Better signal handling for Linux. Fixed by @leaanthony in this PR
  • Running the docs locally was broken due to mandatory crowdin token requirement. Fixed by @OlegGulevskyy in this PR
  • Generated typescript for Go functions that returned a single error was incorrect. Fixed by @ATenderholt in this PR
  • The right mouse event was not being raised correctly for Linux. Fixed by @leaanthony in this PR
  • Remove extra spaces in Wails version when querying go.mod. Fixed by @matholt in this PR
  • Fix go tests failure on Mac. Fixed by @avengerweb in this PR
  • Fix go test errors. Fixed by @misitebao & @avengerweb in these PRs
  • Added WindowSetAlwaysOnTop to the JS runtime. Fixed by @gotid in PR
  • Fixed obfuscated flag typo in docs. Fixed by @ckilb in PR
  • Fixed React Hash Router link in docs. Fixed by @marvinhosea in PR

Changed​

  • Improve error message if no index.html could be found in the assets and validate assetserver options. Changed by @stffabi in this PR
  • Promote the Go WebView2Loader from experimental to stable. This means now per default all Wails build use the new loader introduced with v2.2.0. The old loader remains usable with build tag native_webview2loader for the next few releases. Changed by @stffabi in this PR
  • Refactored CLI. Changed by @leaanthony in this PR
  • Remove unreachable code. Changed by @tmclane in this PR

v2.2.0 - 2022-11-09​

Added​

  • Wails now uses a purpose built, native Go implementation of Microsoft's webview2loader dll. This means there is no need to embed the Webview2Loader.dll file in your binaries, meaning filesizes will be ~130k smaller! Thanks to @stffabi for this awesome contribution!
  • This release provides much more control over custom asset handling via the new AssetServer options. This allows you to provide your own custom asset handler and hook into the request chain through middleware. Thanks to @stffabi for this awesome contribution and @mholt for the initial idea and extensive testing.
  • It is now possible to customise the layout of your Wails projects using 2 new options in wails.json:
    • build:dir can be used to specify where the build files reside
    • frontend:dir can be used to specify where the frontend files reside
    • If go.mod is not found in the same directory as wails.json, the cli will look up the parent directories to find it. Fixed by @leaanthony in this PR
  • Colour output in the CLI can now be turned off by using the --nocolor flag. This is useful for CI/CD pipelines. Thanks to @scottopell for the PR
  • A JSON schema definition for the wails.json file has been added. IDEs should now provide code complete when editing wails.json. Thanks to @binyamin for the PR
  • The EventsOn* methods now return a function that can be called to deregister the listener. Thanks to @joshbuddy for the PR

Fixed​

  • Webview2 on Windows returns a potential whitespace when defining the style like this style="--wails-draggable: drag". Fixed by @stffabi in https://github.com/wailsapp/wails/pull/1989
  • Bound structs that had struct{} field types would cause the TypeScript generation to fail. Thanks to @ParkourLiu for the PR
  • When maximising a frameless window on Windows with multiple monitors, the window could sometimes become blank. Thanks to @stffabi for the fix

Changed​

  • The troubleshooting guide was updated to provide guidance when Vite fails to start. Thanks to @willdot for the PR.
  • English, Chinese and Japanese documentation updates. Thanks to @misitebao.

Deprecated​

New Contributors​

v2.1.0 - 2022-10-18​

Removed​

  • The RGBA option in options.App has now been removed. Use BackgroundColour instead.

Added​

Fixed​

Changed​

New Contributors​

v2.0.0 - 2022-09-22​

Fixed​

Changed​

New Contributors​

v2.0.0-rc.1 - 2022-09-13​

Deprecated​

  • The -noGen flag for the wails dev command has been replaced with -skipbindings. This is to align with the wails build command.

Added​

Fixed​

Changed​

New Contributors​

v2.0.0-beta.44 - 2022-08-20​

Deprecated​

The data-wails-drag attribute is being deprecated in favour of the following CSS style: style="--wails-draggable:drag". You can use style="--wails-draggable:no-drag" to disable the drag behaviour. For this release only, you can test this by setting the following application option:

Experimental: &options.Experimental{
  UseCSSDrag: true,
},

Added​

Fixed​

Changed​

New Contributors​

v2.0.0-beta.43 - 2022-08-08​

Added​

Fixed​

Changed​

New Contributors​

v2.0.0-beta.42 - 2022-07-25​

Added​

  • Added options.NewRGBA and options.NewRGB functions to create *options.RGBA by @leaanthony

Fixed​

v2.0.0-beta.40 - 2022-07-24​

Added​

Fixed​

Changed​

Deprecated​

  • The Fullscreen application option is deprecated. Please use WindowStartState instead.

New Contributors​

v2.0.0-beta.39.2 - 2022-07-20​

Added​

Fixed​

v2.0.0-beta.39 - 2022-07-19​

Added​

Fixed​

Changed​

New Contributors​

Full Changelog: https://github.com/wailsapp/wails/compare/v2.0.0-beta.38...v2.0.0-beta.39

v2.0.0-beta.38 - 2022-06-27​

Added​

Fixed​

Changed​

New Contributors​

v2.0.0-beta.37 - 2022-05-26​

Added​

Fixed​

Changed​

New Contributors​

v2.0.0-beta.36 - 2022-04-27​

Fixed​

Changed​

  • Added OnStartup method back to default templates

v2.0.0-beta.35 - 2022-04-27​

Breaking Changes​

  • When data was sent to the EventsOn callback, it was being sent as a slice of values, instead of optional parameters to the method. EventsOn now works as expected, but you will need to update your code if you currently use this. More information
  • The broken bindings.js and bindings.d.ts files have been replaced by a new JS/TS code generation system. More details here

Added​

  • New Templates: Svelte, React, Vue, Preact, Lit and Vanilla templates, both JS and TS versions. wails init -l for more info.
  • Default templates now powered by Vite. This enables lightning fast reloads when you use wails dev!
  • Add support for external frontend development servers. See frontend:dev:serverUrl in the project config - @stffabi
  • Fully configurable dark mode for Windows.
  • Hugely improved WailsJS generation (both JavaScript and TypeScript)
  • Wails doctor now reports information about the wails installation - @stffabi
  • Added docs for code-signing and NSIS installer - @gardc
  • Add support for -trimpath build flag
  • Add support for a default AssetsHandler - @stffabi

Fixed​

  • Improved mimetype detection for BOM marker and comments - @napalu
  • Remove duplicate mimetype entries - @napalu
  • Remove duplicate TypeScript imports in generated definition files - @adalessa
  • Add missing method declaration - @adalessa
  • Fix Linux sigabrt on start - @napalu
  • Double Click event now works on elements with data-wails-drag attribute - @jicg
  • Suppress resizing during minimize of a frameless window - @stffabi
  • Fixed TS/JS generation for Go methods with no returns
  • Fixed WailsJS being generated in project directory

Changed​

  • Website docs are now versioned
  • Improved runtime.Environment call
  • Improve the close action for Mac
  • A bunch of dependabot security updates
  • Improved website content - @misitebao
  • Upgrade issue template - @misitebao
  • Convert documents that don't require version management to individual pages
  • Website now using Algolia search

v2.0.0-beta.34 - 2022-03-26​

Added​

  • Add support for 'DomReady' callback on linux by @napalu in #1249
  • MacOS - Show extension by default by @leaanthony in #1228

Fixed​

  • [v2, nsis] Seems like / as path separator works only for some directives in a cross platform way by @stffabi in #1227
  • import models on binding definition by @adalessa in #123
  • Use local search on website by @leaanthony in #1234
  • Ensure binary resources can be served by @napalu in #1240
  • Only retry loading assets when loading from disk by @leaanthony in #1241
  • [v2, windows] Fix maximised start state by @stffabi in #1243
  • Ensure Linux IsFullScreen uses GDK_WINDOW_STATE_FULLSCREEN bitmask appropriately. by @ianmjones in #1245
  • Fix memory leak in ExecJS for Mac by @leaanthony in #1230
  • Fix, or at least a workaround, for (#1232) by @BillBuilt in #1247
  • [v2] Use os.Args[0] for self starting wails by @stffabi in #1258
  • [v2, windows] Windows switch scheme: https -> http by @stefpap in #1255
  • Ensure Focus is regained by Webview2 when tabbing by @leaanthony in #1257
  • Try to focus window when Show() is called. by @leaanthony in #1212
  • Check system for user installed Linux dependencies by @leaanthony in #1180

Changed​

  • feat(website): sync documents and add content by @misitebao in #1215
  • refactor(cli): optimize default templates by @misitebao in #1214
  • Run watcher after initial build by @leaanthony in #1216
  • Feature/docs update by @leaanthony in #1218
  • feat(website): optimize website and sync documents by @misitebao in #1219
  • docs: sync documents by @misitebao in #1224
  • Default index page by @leaanthony in #1229
  • Build added win32 compatibility by @fengweiqiang in #1238
  • docs: sync documents by @misitebao in #1260

v2.0.0-beta.33 - 2022-03-05​

Added​

  • NSIS Installer support for creating installers for Windows applications - Thanks @stffabi 🎉
  • New frontend:dev:watcher command to spin out 3rd party watchers when using wails dev - Thanks @stffabi🎉
  • Remote templates now support version tags - Thanks @misitebao 🎉

Fixed​

  • A number of fixes for ARM Linux providing a huge improvement - Thanks @ianmjones 🎉
  • Fixed potential Nil reference when discovering the path to index.html
  • Fixed crash when using runtime.Log methods in a production build
  • Improvements to internal file handling meaning webworkers will now work on Windows - Thanks @stffabi🎉

Changed​

  • The Webview2 bootstrapper is now run as a normal user and doesn't require admin rights
  • The docs have been improved and updated
  • Added troubleshooting guide