Any Migration Guide for v2 to v3?

[tahafatih]

As the title suggests, is there any migration guide or documentation for upgrading from v2 to v3? I want to make sure I follow the recommended steps and best practices during the transition.

[dosubot[bot]]

Hi @tahafatih! I'm Dosu and I’m helping the wails team.

There isn't an official migration guide or consolidated documentation for upgrading from Wails v2 to v3 (source). The only migration guide available is for v1 to v2. However, you can find practical migration patterns and updated usage in recent pull requests and example projects.

For instance, PR #4289 demonstrates porting the deep-link feature from v2 to v3, including new example files, updated frontend bindings, and platform-specific build scripts. PR #4405 shows changes in service naming conventions, frontend asset embedding (now typically embedding frontend/dist), and example project structure.

Community discussions highlight breaking changes and new features, such as tray icon event handling (v3 introduces an OnClick handler for tray icons, which v2 lacks) and changes in Linux GPU policy configuration (discussion).

The best approach is to review the updated example projects in the repository, compare how features are implemented in v3, and adapt your code accordingly. Pay special attention to changes in API usage, project structure, and asset embedding patterns as shown in the latest examples and merged PRs.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[leaanthony]

We'll have a migration guide once we hit Beta 👍

[wierli]

Where is it? I need to upgrade from version 2.10.2 to v3.0.0 alpha36.

[leaanthony]

We'll have a migration guide once we hit Beta 👍