No description
  • Go 66.2%
  • JavaScript 11.9%
  • HTML 10.5%
  • Objective-C 4.2%
  • NSIS 1.8%
  • Other 5.4%
Find a file
Lea Anthony 5d6e9872d4
fix(systray): highlight status item and ensure popup appears above other windows on macOS (#4913)
* fix(systray): highlight status item and ensure popup appears above other windows on macOS

Fixes #4910

This commit addresses two issues with the systray-menu example on macOS:

1. System tray icon not in selected state upon clicking:
   - Added systemTraySetHighlight() function to control the NSStatusBarButton highlight state
   - Set highlight:YES before showing menus via popUpStatusItemMenu
   - Added onAttachedWindowShown/Hidden hooks for managing highlight with attached windows
   - Note: For attached windows, the highlight may briefly flash due to macOS
     NSStatusBarButton behavior where mouse-up clears highlight state

2. Popup doesn't display on top of other windows:
   - Set window level to NSPopUpMenuWindowLevel when positioning systray popup windows
   - Call orderFrontRegardless to ensure the window appears in front

The fix adds onAttachedWindowShown() and onAttachedWindowHidden() to the
systemTrayImpl interface to allow platform-specific handling when the
attached window visibility changes.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs: add changelog entry for systray fixes (#4910)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* chore: trigger fresh CI run

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Simplify systray fix - remove unused window highlight code

Remove onAttachedWindowShown/Hidden interface methods and systemTraySetHighlight
function since they only worked for menus, not attached windows. The menu
highlight (set before popUpStatusItemMenu) and window level fixes remain.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix(v3/macos): use native menu tracking for systray highlight and focus (#4910)

Replace popUpStatusItemMenu: (which never provided native highlighting)
with a local NSEvent monitor that temporarily sets statusItem.menu before
the button processes mouse-down events. This lets macOS handle menu
tracking natively, which:

- Keeps the status bar button highlighted while the menu is open
- Does not activate the app or steal focus from other windows

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-28 16:09:43 +11:00
.beads feat(linux): GTK4 + WebKitGTK 6.0 support (opt-in via -tags gtk4) (#4958) 2026-02-06 21:55:45 +11:00
.github chore(ci): remove Claude Code Review workflows 2026-02-15 14:56:19 +11:00
assets/images [ImgBot] Optimize images (#1812) 2022-09-12 21:57:07 +10:00
docs fix(v3/docs): correct invalid runtime sub-path imports (#4989) 2026-02-28 16:08:41 +11:00
mkdocs-website/docs/en [V3] feat: add Windows getAccentColor implementation (#4427) 2025-07-25 21:46:05 +10:00
scripts Add issue management automation tools 2025-05-14 20:47:45 +10:00
v2 Dependency updates 2025-05-15 06:26:20 +10:00
v3 fix(systray): highlight status item and ensure popup appears above other windows on macOS (#4913) 2026-02-28 16:09:43 +11:00
website feat(linux): GTK4 + WebKitGTK 6.0 support (opt-in via -tags gtk4) (#4958) 2026-02-06 21:55:45 +11:00
.all-contributorsrc [v3] Add starlight website (#3917) 2024-12-08 12:09:13 +11:00
.coderabbit.yaml Add code rabbit for alpha 2024-07-29 20:46:15 +10:00
.gitattributes feat(linux): GTK4 + WebKitGTK 6.0 support (opt-in via -tags gtk4) (#4958) 2026-02-06 21:55:45 +11:00
.gitignore Merge Android support from v3-alpha-feature/android-support 2025-12-10 18:37:24 +11:00
.prettierignore chore: add Prettier as format tool (#2689) 2023-05-30 07:40:54 +10:00
.prettierrc.yml [v3] Add starlight website (#3917) 2024-12-08 12:09:13 +11:00
AGENTS.md feat(linux): GTK4 + WebKitGTK 6.0 support (opt-in via -tags gtk4) (#4958) 2026-02-06 21:55:45 +11:00
CHANGELOG.md chore: sort out files (#1776) 2022-08-22 20:02:27 +10:00
CNAME Add CNAME 2023-10-29 09:48:37 +11:00
CONTRIBUTING.md chore: sort out files (#1776) 2022-08-22 20:02:27 +10:00
CONTRIBUTORS.md Fix BackgroundColour documentation. Update changelog. Move contributors into website. Create changelog link. 2022-07-25 20:11:04 +10:00
IMPLEMENTATION.md feat(linux): GTK4 + WebKitGTK 6.0 support (opt-in via -tags gtk4) (#4958) 2026-02-06 21:55:45 +11:00
IOS_ARCHITECTURE.md Merge iOS support from v3-alpha-feature/ios-support 2025-12-10 18:34:21 +11:00
LICENSE Update license and readme 2019-04-08 19:18:39 +10:00
pr_4570.diff feat(linux): GTK4 + WebKitGTK 6.0 support (opt-in via -tags gtk4) (#4958) 2026-02-06 21:55:45 +11:00
qodana.yaml Add status table to docs. 2023-09-06 20:59:45 +10:00
README.de.md German Readme (#3483) 2024-06-08 21:15:42 +10:00
README.es.md German Readme (#3483) 2024-06-08 21:15:42 +10:00
README.fr.md German Readme (#3483) 2024-06-08 21:15:42 +10:00
README.ja.md German Readme (#3483) 2024-06-08 21:15:42 +10:00
README.ko.md German Readme (#3483) 2024-06-08 21:15:42 +10:00
README.md German Readme (#3483) 2024-06-08 21:15:42 +10:00
README.pt-br.md German Readme (#3483) 2024-06-08 21:15:42 +10:00
README.ru.md Update README.ru.md (#3544) 2024-06-17 18:40:22 +10:00
README.tr.md Added README.tr.md for supporting turkish language (#3528) 2024-06-08 09:51:35 +10:00
README.uz.md German Readme (#3483) 2024-06-08 21:15:42 +10:00
README.zh-Hans.md German Readme (#3483) 2024-06-08 21:15:42 +10:00
SECURITY.md Update SECURITY.md 2024-02-14 18:15:24 +11:00
Taskfile.yaml Docs change 2024-12-13 22:00:25 +11:00
test-changelog-extraction.sh Add test workflow for nightly releases 2025-07-06 06:59:28 +10:00
test-ios-compile.sh Merge iOS support from v3-alpha-feature/ios-support 2025-12-10 18:34:21 +11:00
test-version-logic.sh Add test workflow for nightly releases 2025-07-06 06:59:28 +10:00
test-workflow.md Add test workflow for nightly releases 2025-07-06 06:59:28 +10:00


Build desktop applications using Go & Web Technologies.

GitHub Go Reference CodeFactor Awesome Discord
Build GitHub tag (latest SemVer pre-release)

Table of Contents

Introduction

The traditional method of providing web interfaces to Go programs is via a built-in web server. Wails offers a different approach: it provides the ability to wrap both Go code and a web frontend into a single binary. Tools are provided to make this easy for you by handling project creation, compilation and bundling. All you have to do is get creative!

Features

  • Use standard Go for the backend
  • Use any frontend technology you are already familiar with to build your UI
  • Quickly create rich frontends for your Go programs using pre-built templates
  • Easily call Go methods from Javascript
  • Auto-generated Typescript definitions for your Go structs and methods
  • Native Dialogs & Menus
  • Native Dark / Light mode support
  • Supports modern translucency and "frosted window" effects
  • Unified eventing system between Go and Javascript
  • Powerful cli tool to quickly generate and build your projects
  • Multiplatform
  • Uses native rendering engines - no embedded browser!

Roadmap

The project roadmap may be found here. Please consult it before creating an enhancement request.

Getting Started

The installation instructions are on the official website.

Sponsors

This project is supported by these kind people / companies:

FAQ

  • Is this an alternative to Electron?

    Depends on your requirements. It's designed to make it easy for Go programmers to make lightweight desktop applications or add a frontend to their existing applications. Wails does offer native elements such as menus and dialogs, so it could be considered a lightweight electron alternative.

  • Who is this project aimed at?

    Go programmers who want to bundle an HTML/JS/CSS frontend with their applications, without resorting to creating a server and opening a browser to view it.

  • What's with the name?

    When I saw WebView, I thought "What I really want is tooling around building a WebView app, a bit like Rails is to Ruby". So initially it was a play on words (Webview on Rails). It just so happened to also be a homophone of the English name for the Country I am from. So it stuck.

Stargazers over time

Star History Chart

Contributors

The contributors list is getting too big for the readme! All the amazing people who have contributed to this project have their own page here.

License

FOSSA Status

Inspiration

This project was mainly coded to the following albums: