This commit introduces comprehensive iOS platform support for Wails v3, enabling
developers to build native iOS applications using Go and web technologies.
Key Features:
- Full iOS application lifecycle management with WKWebView integration
- Native iOS options configuration (scroll, bounce, navigation gestures, media playback)
- iOS-specific build system with Xcode project generation
- Support for iOS simulators and physical devices
- Native tab bar (UITabBar) integration with SF Symbols
- iOS runtime API for platform-specific functionality
- Complete example iOS application with Puppertino UI framework
- iOS template for new projects
- Build tasks and configuration for iOS development
- Support for input accessory view management
- Custom user agent configuration
- Background color support for iOS windows
Technical Implementation:
- iOS-specific message processor for event handling
- Native Objective-C bridges for iOS APIs
- WKWebView configuration and management
- iOS asset handling and bundling
- Proper build constraints for iOS platform
- Integration with existing Wails v3 architecture
This enables developers to target iOS alongside existing desktop platforms
(macOS, Windows, Linux) using a single Go + web technology codebase.
Co-Authored-By: Claude <noreply@anthropic.com>
* Check for empty buffers instead of nil in responsewriter
Use Case:
I am using a service that implements `http.Handler` to send streaming
video to the frontend. Reliably, when sending fragmented MP4 data on
MacOS, the app would panic because the buffer being sent through the
response passed a not-nil check but would panic when accessing the first
byte of the buffer.
This PR addresses that by checking if the buffer is not empty instead of
nil, accounting for the case where len(buf) == 0 and cap(buf) > 0, or
maybe where buf[0] == '\0' (I'm not sure how the nil checks work for
slices)
* Update UNRELEASED_CHANGELOG
* Update v3/internal/assetserver/webview/responsewriter_darwin.go
nil and len check
---------
Co-authored-by: Atterpac <89053530+atterpac@users.noreply.github.com>
* fix(macOS): Use visibleFrame for window centering to exclude menu bar
The windowCenter() function was using [screen frame] which includes
the menu bar and dock areas, causing windows to appear positioned
too high on the screen when centered.
This change uses [screen visibleFrame] instead, which excludes the
menu bar and dock areas, resulting in proper visual centering.
Fixes vertical centering issue on macOS in Wails v3 alpha.
* Update v3/UNRELEASED_CHANGELOG.md
* Update changelog entry format
---------
Co-authored-by: Atterpac <89053530+atterpac@users.noreply.github.com>
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* feat: Implement native Liquid Glass effect for macOS
feat: Add platform check for Liquid Glass demo
Show informative dialog on Windows/Linux explaining that the Liquid Glass
effect is a macOS-specific feature. The demo will exit gracefully on
non-macOS platforms.
docs: Add Liquid Glass feature to unreleased changelog
feat: Enhanced Liquid Glass effect with NSVisualEffectMaterial support
Major improvements to the Liquid Glass implementation for macOS:
- Added comprehensive NSVisualEffectMaterial support with 15+ material options
- Removed debug NSLog statements for cleaner production code
- Created multi-window demo showcasing 7 different glass effects:
* Light Style - Clean light appearance
* Dark Style - Dark themed glass
* Vibrant Style - Enhanced transparency
* Blue Tint - Custom RGBA tint color example
* Sheet Material - NSVisualEffectMaterialSheet
* HUD Window - Ultra-light HUD material
* Content Background - With warm tint color
- Added Material field to MacLiquidGlass struct for fine-grained control
- Improved demo design with proper Title Case and cleaner layout
- Fixed logo sizing to prevent blur
- All windows fully draggable with InvisibleTitleBarHeight
- Added comprehensive README documentation
The implementation now provides developers with complete control over the
glass effect appearance, supporting both native NSGlassEffectView (macOS 15.0+)
and NSVisualEffectView fallback for older systems.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
feat: Implement native Liquid Glass effect for macOS
- Add support for NSGlassEffectView on macOS 15.0+
- Implement runtime detection of native glass APIs
- Add fallback to enhanced NSVisualEffectView for older systems
- Update liquid glass demo with frameless windows for better visibility
- Support all NSGlassEffectView properties (cornerRadius, tintColor, style)
- Properly handle webview layering with glass effect
- Remove binary from version control
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* fix: Address CodeRabbit review feedback
- Comment out unimplemented ReduceMotion and StaticMode fields
- Remove overly broad draggable CSS properties
- Add corner radius validation
- Improve CSS with proper pointer-events and user-select
- Add clarifying comments about future features
* fix: Remove unimplemented ReduceMotion and StaticMode fields
Completely remove the commented-out performance optimization fields
as they are not implemented and have no timeline for implementation.
* fix: Update windowRemoveVisualEffects to also remove NSGlassEffectView instances
The cleanup function now properly removes both NSVisualEffectView and
NSGlassEffectView instances to prevent orphaned effect layers. Uses
NSClassFromString to avoid hard references to NSGlassEffectView which
is only available on macOS 15.0+.
* fix changelog
* Update v3/pkg/application/webview_window_darwin.m
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update v3/pkg/application/webview_window_darwin.m
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* fix: Fix compilation errors in windowSetLiquidGlass
- Add missing NSGlassEffectViewStyle enum definition
- Fix undefined tintColor variable by creating NSColor before use
- Add autorelease to prevent memory leaks for allocated views
These issues were causing CI build failures while working locally due to different compiler settings.
* Update Taskfile.yaml
* feat: Implement groupID and groupSpacing for NSGlassEffectView
- Add runtime detection for groupIdentifier/groupName selectors
- Apply groupID via performSelector if supported
- Apply groupSpacing via KVC if supported
- Parameters are now functional when NSGlassEffectView supports them
- Maintains backward compatibility by checking selector availability
* test: Add liquid-glass example to test suite
- Add liquid-glass to EXAMPLEDIRS in Taskfile.yaml
- Ensures the example is tested during CI builds
- Validates compilation on different platforms
Addresses review comment about missing test coverage
* fix: Correct NSGlassEffectView availability to macOS 26.0
- Update @available checks from macOS 15.0 to 26.0 for NSGlassEffectView
- NSGlassEffectView is a private API introduced in macOS 26.0
- Update README to reflect correct version requirement
- Keep NSVisualEffectMaterial checks at 15.0 as those are different APIs
* fix: Prevent exceptions from unsafe WebView reparenting
- Remove early WebView addition to glassView.contentView
- Consolidate all WebView reparenting in one safe location
- Always call removeFromSuperview before adding to new parent
- Set frame and autoresizing mask after safe reparenting
- Prevents NSInternalInconsistencyException from multiple parents
* fix: Make WebView reparenting more robust and thread-safe
- Always call removeFromSuperview before adding to new parent
- Remove brittle superview check, always detach and reattach
- Check both webView and glassContentView are non-nil before operations
- Ensure all UI operations run on main thread with dispatch_sync
- Set frame and autoresizing mask after safe reparenting
* Tidy up
* Update changelog
---------
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* fix: make options in update build-assets override
Before this fix, if `-config` was passed to `wails3 update
build-assets`, the values in the config file, even if they were empty,
would be used. Now, we only use the config file value if the value was
not passed in on the command line (or is the zero value or default value
for the option).
I'll be honest, I feel a little dirty about this implementation since
I had to copy string constants out of struct tags. Not very DRY of me.
That said, there was no obvious way to get the default value of a given
option. If I missed something, happy to have this corrected, but I've
tested it and it seems to be doing the things it should be doing.
* Update v3 changelog
* Fix SetBackgroundColour on Windows
Update Chromium window color on calls to SetBackgroundColour.
* update changelog
* v3.0.0-alpha.23
---------
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
* Correct nfpm.yaml template package dependencies.
As is, the `nfpm.yaml` template pulls in `-dev` versions of the packages the built Wails application actually relies on, in addition to `build-essential`. Which will work, but is way overkill. This PR corrects this.
I have tested this on an Ubuntu 22.04 VM and a Rocky Linux 10 VM, *(which actually necessitated attaching the EPEL repository)* but I did not verify Arch beyond looking up packages.
Additionally, it appears that the package name for RPM distro family is not in tune with the rest of them, referring to an earlier version of webkit2gtk, which has also been corrected.
**P.S.** Could we supply our own templates or updatable build files pretty please?
* Addressing points brought up.
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* feat: Add Content Protection for Windows and macOS
- Prevents window contents from being captured by screen recording/sharing software
- Windows: Uses WDA_EXCLUDEFROMCAPTURE on Windows 10 2004+, falls back to WDA_MONITOR
- macOS: Uses NSWindowSharingType to set window as read-only for screen sharing
- Added ContentProtectionEnabled option to WebviewWindowOptions
- Added SetContentProtection() method for runtime control
- Added comprehensive documentation and example usage
* fix changelog.mdx
* Misc fixes
* Misc fixes
* Update v3/pkg/w32/user32.go
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
* Remove debug line
---------
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
* fix: v3-alpha WindowUnMinimise not fired when window is maximized ( Windows )
* add fix to changelog.mdx
* Apply suggestion from @coderabbitai[bot]
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
* (docs) installation.mdx: update required Go version to 1.24
* (docs) update for Manager API Refactoring https://github.com/wailsapp/wails/pull/4359
* add entry in UNRELEASED_CHANGELOG.md to satisfy github actions
* thx coderabbitai
* thx coderabbitai
* ## Summary
I've successfully fixed the nil pointer dereference bug in the Wails v3 system tray functionality on Windows. Here's what I addressed:
**Root Cause**: The bug occurred in `systemtray_windows.go:80` where `*trayBounds = PhysicalToDipRect(*trayBounds)` was dereferencing a potentially nil pointer without checking.
**Fixes Applied**:
1. **`positionWindow` method (lines 80-82)**: Added nil check for `trayBounds` before dereferencing
2. **`bounds` method (lines 121-123, 129-131)**: Added checks for uninitialized `hwnd` and nil return from `GetSystrayBounds`
3. **`iconIsInTrayBounds` method (lines 147-149, 155-157, 160-162)**: Added similar protective checks and taskbar position validation
4. **`getScreen` method (lines 173-175)**: Added `hwnd` initialization check
5. **`openMenu` method (lines 45-47)**: Added nil check for `trayBounds`
**Key Improvements**:
- Added proper initialization checks for `s.hwnd == 0`
- Added nil pointer checks for all Windows API return values
- Ensured graceful error handling instead of panics
- Maintained existing functionality while preventing race conditions
The fix addresses the race condition where system tray operations could be called before the tray was fully initialized, preventing the nil pointer dereference panic described in issue #4456.
* Update changelog
* new events
* macOS dnd improvements
* wailsio adds for dropzone
* update example
* sorta working
the top 300px of the window are not dropabble for some reason i suspect it has to do with the drag enter/drag leave xy as the performOperation needed to use the ContentView for appropriate X/Y
* implement attribute detection for data-wails-dropzone
* docs
* pass x/y dnd linux
* cleanup exmample
* changelog
* pass all attributes to golang on dragdrop
* filetree example
* fix dnd build windows
* Fix windows dnd
* update docs
* remove debug log
* appease the security bot
* Fix changelog
* Fix changelog
* Revert "Fix event generation issues."
This reverts commit ae4ed4fe
* Fix events
* Fix merge conflicts. Fix events generation formatting
* Update docs
* Fix duplicate bundledassets import causing build failures
Remove duplicate import of bundledassets package that was causing
compilation errors in PR #4318. The import was declared twice in
the same import block, causing "bundledassets redeclared" errors.
Fixes build issues in GitHub Actions for drag-and-drop zones feature.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Replace fmt.Printf debug statements with globalApplication.debug
Replace all fmt.Printf debug logging statements in drag-and-drop
functionality with proper globalApplication.debug calls. This provides:
- Consistent logging with the rest of the application
- Proper key-value structured logging
- Better integration with the application's logging system
- Cleaner debug output format
Changes:
- application_darwin.go: Replace 2 fmt.Printf calls
- webview_window.go: Replace 6 fmt.Printf calls
- webview_window_windows.go: Replace 13 fmt.Printf calls
- Remove unused fmt import from application_darwin.go
All debug messages maintain the same information but now use
structured logging with key-value pairs instead of printf formatting.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Add nil checks to WindowEventContext methods
Ensure all WindowEventContext methods properly handle nil c.data
by initializing the map when it's nil. This prevents panics when
methods are called on contexts that haven't been properly initialized.
Changes:
- DroppedFiles(): Add nil check and map initialization
- setCoordinates(): Add nil check and map initialization
- setDropZoneDetails(): Add nil check and map initialization
- DropZoneDetails(): Add nil check and map initialization
All methods now follow the same pattern as setDroppedFiles()
where a nil data map is automatically initialized to prevent
runtime panics during drag-and-drop operations.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Update v3/pkg/application/webview_window_darwin.m
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
* reinstate events docs.
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
* fix(application): handle error and type assertion in save file dialog
---------
Co-authored-by: hkhere <hk@tinyclouds.cn>
Co-authored-by: Atterpac <89053530+atterpac@users.noreply.github.com>
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* fix(windows): disable external drag only when EnableDragAndDrop is set
* update changelog for html dnd fix
* remove redundant commented out code for windows dnd
* Fix changelog
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
Co-authored-by: Atterpac <89053530+atterpac@users.noreply.github.com>
* Adding the ability to pass custom args to windows webview2
---------
Co-authored-by: Jason Gibson <jason@harbingerinteractive.com>
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* ## Summary
I have successfully implemented support for `allowsBackForwardNavigationGestures` in Wails v3. Here's what I accomplished:
### Investigation Results
- **Issue Status**: The feature was **NOT** previously implemented in Wails v3
- **go-webview2**: This library is Windows-only and doesn't provide macOS WKWebView features
- **Need**: A native implementation was required specifically for macOS WKWebView
### Implementation Details
1. **Added new option**: `AllowsBackForwardNavigationGestures u.Bool` to `MacWebviewPreferences`
2. **Extended C bridge**: Updated the C struct to pass the preference to Objective-C code
3. **Implemented WKWebView setting**: Added code to set `webView.allowsBackForwardNavigationGestures` during initialization
4. **Updated preference processing**: Extended the Go code to handle the new preference
### Key Files Modified
- `v3/pkg/application/webview_window_options.go`: Added the preference option
- `v3/pkg/application/webview_window_darwin.go`: Implemented the C bridge and WKWebView configuration
### Usage Example
```go
window.SetOptions(application.WebviewWindowOptions{
Mac: application.MacWindow{
WebviewPreferences: application.MacWebviewPreferences{
AllowsBackForwardNavigationGestures: u.True(),
},
},
})
```
### Testing
- ✅ Code compiles successfully
- ✅ Created working example demonstrating the feature
- ✅ Follows existing Wails v3 patterns and conventions
### Benefits
- Provides native macOS two-finger swipe navigation
- Better performance than JavaScript alternatives
- Maintains accessibility features
- Seamless integration with existing Wails v3 API
The implementation is ready for testing and could be submitted as a PR to the Wails repository. The feature addresses the exact requirements from GitHub issue #1857 and provides both specific and API-consistent access to WKWebView's navigation gesture functionality.
* Perfect! I have:
1. ✅ Removed the `NAVIGATION_GESTURES_FEATURE.md` file
2. ✅ Removed the `example_navigation_gestures.go` file
3. ✅ Updated the `UNRELEASED_CHANGELOG.md` with a FIX entry
The changelog entry properly documents that this fix adds support for `allowsBackForwardNavigationGestures` in macOS WKWebView to enable two-finger swipe navigation gestures, referencing issue #1857.
The implementation is now clean and ready, with only the essential code changes remaining and the changelog properly updated to reflect the fix.
* Fix: macOS disabled menu item callback issue
Fixes bug where menu items that are initially disabled do not fire
their OnClick callbacks after being enabled via SetEnabled(true).
Problem:
- When creating disabled menu items, actions were not set
- When re-enabling, targets were not properly restored based on action type
- This caused callbacks to never fire for initially-disabled items
Solution:
1. Always set action during menu item creation regardless of disabled state
2. Set appropriate targets based on action type and disabled state
3. Enhanced setMenuItemDisabled to restore correct targets when re-enabling:
- Custom callbacks (@selector(handleClick)): target = menuItem
- Role-based actions (system selectors): target = nil (responder chain)
This ensures that menu items with OnClick callbacks work correctly
regardless of their initial disabled state.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Update changelog
* Update changelog
---------
Co-authored-by: Claude <noreply@anthropic.com>
* fix: properly clean up Vite server when build fails
Ensures the Vite server process is terminated when a build fails
during 'wails3 dev', preventing port conflicts on subsequent runs.
Fixes#4403🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* fix: add defer for watcher cleanup and tidy up returns
- Add defer cleanup() to ensure resources are always freed
- Remove manual cleanup in error path since defer handles it
- Simplify error handling for better maintainability
Addresses feedback on PR #4436
* fix: prevent channel deadlock in watcher cleanup
- Separate cleanup logic from channel notification
- cleanup() only stops the engine
- signalCleanup() handles both cleanup and channel notification
- Prevents deadlock when function exits normally
---------
Co-authored-by: Claude <noreply@anthropic.com>
* Add goModTidy function to clean up Go module dependencies during installation (#4283)
* Add goModTidy function and update changelog for automatic execution after wails init (#4283)
* Update CLI documentation to clarify bypassing 'go mod tidy' during project initialization (#4283)
* Add -skipgomodtidy flag to CLI and update installation logic to conditionally run go mod tidy
* Update CLI documentation to reflect default value of -skipgomodtidy flag and clean up code (#4283)
* Update docs/src/content/docs/guides/cli.mdx
* fix changelog
---------
Co-authored-by: Triadmoko Denny Fatrosa <triadmoko.fatrosa@codemi.co.id>
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
Add explicit base_ref checks to ensure the v3 build and test workflow
only runs for PRs targeting the v3-alpha branch.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Fix backtick command substitution error using here-document
- Add extra spacing before disclaimer section
- Simplify commit message to just version number
- Add comprehensive test files for release notes creation
- Add edge case testing for empty changelogs and comments
- Add documentation explaining how the feature works
- Verify all functionality works as expected
The workflow now explicitly checks out v3-alpha branch, so the job-level
condition 'if: github.ref == refs/heads/v3-alpha' is no longer needed
and was preventing manual runs from other branches.
* fix: enhance doctor command to verify Windows SDK dependencies ([#4390](https://github.com/wailsapp/wails/issues/4390))
- Updated the doctor command to check for the presence of Windows SDK dependencies, improving the setup process for Windows users.
- Added relevant entry to the changelog for better documentation of this fix.
* Update changelog
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
Remove all test files, extra workflows, and artifacts.
Keep only:
- changelog-validation-v3.yml (main workflow)
- v3/scripts/validate-changelog.go (validation script)
Tested and working with act.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Remove problematic large workflow files
- Add final clean 'Changelog Validation (v3)' workflow
- Tested and working with act
- Uses external Go script for maintainability
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Successfully tested with act - validation script and PR diff detection working
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Created external Go validation script in v3/scripts/
- Clean workflow file without embedded scripts (much smaller)
- Should properly show workflow_dispatch trigger in GitHub
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed line 422 YAML syntax error by using single-line commit message
Verified working with act dry-run test
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed multiline commit message using HEREDOC syntax on line 421
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
This workflow validates changelog entries in PRs targeting v3-alpha branch:
- Detects entries added to already-released versions using diff analysis
- Automatically moves misplaced entries to [Unreleased] section
- Uses proper ### Category format for Keep a Changelog compliance
- Commits fixes back to PR with clear feedback
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* feat: Add distribution-specific dependencies using nfpm overrides
Implements feature #4339 by enhancing the nfpm.yaml.tmpl to use nfpm's built-in
overrides feature for different Linux distributions and package formats.
## Changes Made:
### Enhanced nfpm configuration with overrides:
- **Default**: Debian 12/Ubuntu 22.04+ with WebKit 4.1 dependencies
- Uses libgtk-3-dev, libwebkit2gtk-4.1-dev, build-essential, pkg-config
- **RPM override**: RHEL/CentOS/AlmaLinux/Rocky Linux with WebKit 4.0 dependencies
- Uses gtk3-devel, webkit2gtk3-devel, gcc-c++, pkg-config
- **Arch override**: Arch Linux with WebKit 4.1 dependencies
- Uses gtk3, webkit2gtk-4.1, base-devel, pkgconf
This approach uses nfpm's native override system to automatically select
the correct dependencies based on the target package format, ensuring
that each distribution gets the appropriate WebKit version and package names.
### How it works:
- DEB packages get WebKit 4.1 dependencies (default)
- RPM packages get WebKit 4.0 dependencies (RHEL/CentOS compatibility)
- Arch packages get WebKit 4.1 dependencies with Arch-specific package names
Fixes#4339🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* feat: Enhance wails doctor with WebKit fallback support
Improves the doctor command to better detect WebKit dependencies across
different Linux distributions by adding fallback package support.
## Changes Made:
### Enhanced Package Manager Detection:
- **APT (Debian/Ubuntu)**: Added WebKit 4.1 → 4.0 fallback support
- **DNF (Fedora/RHEL)**: Added webkit2gtk4.0-devel fallback for older systems
- **Zypper (SUSE)**: Added webkit2gtk4_1-devel for modern SUSE distributions
- **Emerge (Gentoo)**: Added support for both webkit-gtk:6 and webkit-gtk:4 slots
- **Pacman (Arch)**: Added fallback from webkit2gtk-4.1 to webkit2gtk
### Improved Developer Experience:
- Doctor command now tries newer WebKit versions first, falls back gracefully
- Provides more accurate dependency detection across distributions
- Better guidance for developers on different Linux systems
### How It Works:
- Each package manager lists multiple WebKit package options in order of preference
- The dependency system tries packages in order until it finds one that's available
- Developers get appropriate installation commands for their specific distribution
This complements the nfpm overrides by ensuring developers can properly
set up their development environment regardless of distribution.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* update changelog
---------
Co-authored-by: Claude <noreply@anthropic.com>
- Detects changes in v2 and v3-alpha branches independently
- Runs release scripts and extracts changelog notes
- Creates GitHub releases with proper tags and release notes
- Supports dry-run mode for testing
- Authorization controls for release permissions
- Comprehensive change detection and summary reporting
- Currently disabled (no schedule) for safety
- Added extractReleaseNotes function to extract content from Unreleased section
- Script now prints release notes between delimiter markers
- Release notes can be captured for use in GitHub release tags
- Maintains existing functionality for updating changelog with version/date
- Mirrors v2 release script functionality for consistency
- Created test-nightly-releases.yml for safe testing
- Added local test scripts for changelog extraction and version logic
- Updated nightly-releases.yml with changelog integration
- Ready for dry-run testing
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Fix OpenFileManager on windows
- Use cmd.SysProcAttr.CmdLine to invoke explorer.exe on Windows
- separate platform-specific code in package fileexplorer into separate files
* Update changelog.mdx
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
Add path filter to ensure Build + Test v3 workflow only runs on
PRs targeting v3-alpha branch that actually modify v3/ directory.
This prevents the workflow from running on master branch PRs.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Remove `dir: examples` from test:examples task to fix working directory
conflict in GitHub Actions. The workflow sets working-directory to v3,
and the individual example tasks already specify their own directories.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* fixed bug with nil window in processURLRequest
* added row to changelog and added log
* removed old code
* Fix getWindowForID undefined error in processURLRequest
Replace non-existent globalApplication.getWindowForID() call with
the correct globalApplication.Window.GetByID() method. This fixes
the compilation error while preserving the nil check functionality
that was intended in the original PR.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Add explicit nil check for safer window validation
Add an additional nil check alongside the boolean check from GetByID()
to handle edge cases where a window interface could theoretically be
nil even when the lookup indicates success. This provides defense
in depth against nil pointer dereferences.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Change window not found log to debug level
Use globalApplication.debug() instead of log.Println() for missing
window ID messages. This is more appropriate as it's diagnostic
information rather than a user-facing error.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Remove unused log import
Remove the "log" import that is no longer needed after switching
to globalApplication.debug() for logging.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
Co-authored-by: Claude <noreply@anthropic.com>
* Refactor Manager API to use singular naming convention
This is a RENAME-ONLY exercise that converts the Wails v3 Manager API from plural to singular naming for better consistency and clarity.
## Changes Applied
### API Transformations:
- `app.Windows.*` → `app.Window.*`
- `app.Events.*` → `app.Event.*`
- `app.ContextMenus.*` → `app.ContextMenu.*`
- `app.KeyBindings.*` → `app.KeyBinding.*`
- `app.Dialogs.*` → `app.Dialog.*`
- `app.Menus.*` → `app.Menu.*`
- `app.Screens.*` → `app.Screen.*`
### Files Updated:
- **Core Application**: 22 files in `v3/pkg/application/`
- **Examples**: 43+ files in `v3/examples/`
- **Documentation**: 13 files in `docs/src/content/docs/`
- **CLI Tests**: 1 file in `v3/internal/commands/`
### Critical Constraints Preserved:
- ✅ Event string constants unchanged (e.g., "windows:WindowShow")
- ✅ Platform event names preserved (events.Windows, events.Mac, etc.)
- ✅ TypeScript API remains compatible
- ✅ All functionality intact
### Verification:
- ✅ All examples build successfully (`task test:examples` passes)
- ✅ Application package compiles without errors
- ✅ Documentation reflects new API patterns
## Benefits
- **Improved Clarity**: Singular names are more intuitive (`app.Window` vs `app.Windows`)
- **Better Consistency**: Aligns with Go naming conventions
- **Enhanced Developer Experience**: Clearer autocomplete and API discovery
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Fix generator testcases and add cross-platform test cleanup
- Update 28 generator testcase files to use singular API (app.Window.New() vs app.Windows.New())
- Add cross-platform cleanup system with Go script to remove test artifacts
- Add test:all task with comprehensive testing and automatic cleanup
- Fix cleanup to target files vs directories correctly (preserves source directories)
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Fix remaining Windows CI failures by updating all plural API usage to singular
Fixed the last remaining instances of old plural Manager API usage:
- tests/window-visibility-test/main.go: Updated all app.Windows -> app.Window and app.Menus -> app.Menu
- internal/templates/_common/main.go.tmpl: Updated app.Windows -> app.Window and app.Events -> app.Event
- pkg/services/badge/badge_windows.go: Updated app.Windows -> app.Window (Windows-specific fix)
These fixes address the Windows CI failures where platform-specific files still used the old API.
The tests didn't catch this locally because Windows-specific files only compile on Windows.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
---------
Co-authored-by: Claude <noreply@anthropic.com>
* Initial refactor
* More refactoring of API
* Update gitignore
* Potential fix for code scanning alert no. 134: Incorrect conversion between integer types
Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
* Update v3/internal/generator/testcases/variable_single_from_function/main.go
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
* Update v3/pkg/application/context_menu_manager.go
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
* Update v3/pkg/application/event_manager.go
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
* Update v3/pkg/application/context_menu_manager.go
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
* Fix build issues
* Fix build issues
* Address CodeRabbitAI review feedback: fix goroutines, error handling, and resource management
- Fix infinite goroutines with proper context cancellation and ticker cleanup
- Add error handling to window creation calls
- Prevent unbounded slice growth in gin-service and screen examples
- Use graceful shutdown patterns with app.Context().Done()
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Fix manager API refactor issues and complete all v3 example builds
- Fixed slices import missing in event_manager.go
- Changed contextMenusLock from sync.Mutex to sync.RWMutex for RLock/RUnlock compatibility
- Updated all globalApplication calls to use new manager pattern (Windows.Current, Events.OnApplicationEvent, etc.)
- Fixed Events.Emit vs Events.EmitEvent method signature mismatch
- Corrected NewWithOptions calls (returns 1 value, not 2) in examples
- Added comprehensive .gitignore patterns for all v3 example binaries
- All 34 v3 examples now build successfully
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Fix Linux platform manager API calls
- Updated events_common_linux.go: OnApplicationEvent → Events.OnApplicationEvent
- Updated application_linux.go: OnApplicationEvent → Events.OnApplicationEvent
- Ensures Linux builds work with new manager pattern
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Fix remaining NewWithOptions assignment errors in examples
- Fixed badge/main.go: removed assignment mismatch and unused variable
- Fixed badge-custom/main.go: removed assignment mismatch and variable reuse
- Fixed file-association/main.go: removed assignment mismatch and unused variable
- All examples now use correct single-value assignment for NewWithOptions()
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Implement multi-architecture Docker compilation system for Linux builds
### New Features
- **Multi-Architecture Support**: Native ARM64 and x86_64 Docker compilation
- **Auto-Detection**: Automatic architecture detection in Taskfile tasks
- **Complete Cross-Platform Testing**: 129 builds (43 examples × 3 platforms)
### Docker Infrastructure
- `Dockerfile.linux-arm64`: Ubuntu 24.04 ARM64 native compilation
- `Dockerfile.linux-x86_64`: Ubuntu 24.04 x86_64 native compilation
- Architecture-specific build scripts with colored output and error handling
- Native compilation eliminates CGO cross-compilation issues
### Task System Updates
- **New Tasks**: `test:examples:all` for complete cross-platform testing
- **Architecture-Specific**: `test:examples:linux:docker:arm64/x86_64`
- **Auto-Detection**: `test:example:linux:docker` detects host architecture
- **Clear Parameter Usage**: Documented when DIR parameter is/isn't needed
### Build Artifacts
- Architecture-specific naming: `testbuild-{example}-linux-{arch}`
- ARM64: `testbuild-badge-linux-arm64`
- x86_64: `testbuild-badge-linux-x86_64`
### Documentation
- Complete TESTING.md overhaul with multi-architecture support
- Clear command reference distinguishing single vs all example builds
- Updated build performance estimates (10-15 minutes for 129 builds)
- Comprehensive troubleshooting and usage examples
### Infrastructure Cleanup
- Removed deprecated `Dockerfile.linux-proper`
- Updated .gitignore for new build artifact patterns
- Streamlined Taskfile with architecture-aware Linux tasks
**Status**: Production-ready multi-architecture Docker compilation system
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Fix CLI appimage testfiles API migration and add to testing system
### API Migration Fixes
- **Event Registration**: Updated `app.OnApplicationEvent()` → `app.Events.OnApplicationEvent()`
- **Window Manager**: Updated `app.CurrentWindow()` → `app.Windows.Current()`
- **Window Creation**: Updated `app.NewWebviewWindowWithOptions()` → `app.Windows.NewWithOptions()`
- **Menu Manager**: Updated `app.SetMenu()` → `app.Menus.SetApplicationMenu()`
- **Screen API**: Updated `app.GetPrimaryScreen()/GetScreens()` → `app.Screens.GetPrimary()/GetAll()`
### Testing System Enhancement
- **New Task**: `task test:cli` for CLI-related code compilation testing
- **Integration**: Added CLI testing to `task test:examples` and `task test:examples:all`
- **Documentation**: Updated TESTING.md to include CLI code testing
### Files Fixed
- `internal/commands/appimage_testfiles/main.go`: Complete API migration
- `Taskfile.yaml`: Added CLI testing tasks and integration
- `TESTING.md`: Updated documentation to reflect CLI testing
This ensures CLI code API migrations are caught by our testing system and prevents
future build breakages in CLI components.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Enhance testing infrastructure and fix API migration issues across v3 codebase
This commit introduces comprehensive testing infrastructure to catch API migration issues and fixes all remaining compatibility problems:
## Enhanced Testing Infrastructure
- Added `test:cli:all` task to validate CLI components compilation
- Added `test:generator` task to test code generator test cases
- Added `test:infrastructure` task for comprehensive infrastructure testing
- Updated `test:examples` to include CLI testing automatically
## API Migration Fixes
- Fixed manager-based API calls in window visibility test (app.Windows.NewWithOptions)
- Fixed manager-based API calls in screen manager tests (sm.GetAll, sm.GetPrimary)
- Fixed event registration API in 6 service test files (app.Events.OnApplicationEvent)
- Updated menu API calls (app.Menus.SetApplicationMenu)
## Cross-Platform Validation
- All 43 examples compile successfully on Darwin
- CLI components compile without errors
- Generator test cases validate correctly
- Application package tests pass compilation
The enhanced testing system integrates with existing GitHub Actions CI/CD and will automatically catch future API migration issues, ensuring ecosystem stability as the v3 API evolves.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Fix template API migration issues and add comprehensive template testing
This commit resolves the GitHub Actions template generation failures by fixing API migration issues in the template source files and adding comprehensive template testing to the infrastructure.
## Template API Fixes
- Fixed `app.NewWebviewWindowWithOptions()` → `app.Windows.NewWithOptions()` in main.go.tmpl
- Fixed `app.EmitEvent()` → `app.Events.Emit()` in main.go.tmpl
- Updated the _common template used by all framework templates (lit, react, vue, etc.)
## Enhanced Testing Infrastructure
- Added `test:templates` task to validate template generation and compilation
- Tests lit and react template generation with API migration validation
- Integrated template testing into `test:infrastructure` task
- Templates now tested alongside CLI components, generator, and application tests
## GitHub Actions Compatibility
- Resolves template generation failures in CI/CD pipeline
- Ensures all generated projects use correct manager-based API calls
- Maintains template consistency across all supported frameworks
The template testing validates that generated projects compile successfully with the new manager-based API pattern, preventing future template generation failures in GitHub Actions.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Reorganize Docker testing files into test directory
- Move Dockerfiles from root to test/docker/
- Update all Taskfile.yaml Docker build paths
- Update TESTING.md documentation
- Maintain full backward compatibility
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Address CodeRabbit review: improve resource management and API patterns
- Store event handler cleanup functions for proper resource management
- Fix goroutine management with context-aware cancellation patterns
- Add documentation for error handling best practices
- Improve API consistency across examples
Examples updated:
- plain: Fixed event handlers and goroutine lifecycle
- badge: Added cleanup function storage
- gin-example: Proper event handler management
- gin-service: Service lifecycle cleanup
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Address CodeRabbit nitpicks: optimize Docker images and docs
Docker Optimizations:
- Add --no-install-recommends and apt-get clean for smaller images
- Add SHA256 checksum verification for Go downloads
- Remove unnecessary GO111MODULE env (default in Go 1.16+)
- Add hadolint ignore for here-doc blocks
Build Enhancements:
- Add --pull flag to Docker builds for fresh base images
- Improve build reliability and consistency
Documentation Fixes:
- Add proper language tags to code blocks (bash, text)
- Fix heading formatting and remove trailing punctuation
- Improve syntax highlighting and readability
Files updated:
- test/docker/Dockerfile.linux-arm64
- test/docker/Dockerfile.linux-x86_64
- Taskfile.yaml
- TESTING.md
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Update changelog: document Manager API refactoring and improvements
Breaking Changes:
- Manager API Refactoring: Complete reorganization from flat structure
to organized managers (Windows, Events, Dialogs, etc.)
- Comprehensive API migration guide with all method mappings
- References PR #4359 for full context
Added:
- Organized testing infrastructure in test/docker/ directory
- Improved resource management patterns in examples
- Enhanced Docker images with optimizations and security
This documents the major architectural changes and improvements
made to the Wails v3 API and development infrastructure.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Support cross-platform testing
---------
Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
* fix incorrect window destroy
* remove duplicate common signals
* Better handling of "shouldclose"
* Better handling of "shouldclose"
* Fix ABI safety issues in exported function for macOS window closing
Address CodeRabbit feedback on ABI safety and data races:
- Change exported function signature to use C types (C.uint, C.bool) for ABI safety
- Convert unconditionallyClose field from bool to atomic uint32 for thread safety
- Update all read/write operations to use atomic operations across platforms
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
Co-authored-by: Claude <noreply@anthropic.com>
This fixes the template execution errors that occurred when running 'wails3 init' with MSIX-related templates. The issue was that the templates were trying to access fields under an 'Info' sub-struct that doesn't exist in the BuildConfig context.
Changes:
- Fixed app_manifest.xml.tmpl to use direct field references (e.g., .ProductIdentifier instead of .Info.ProductIdentifier)
- Fixed template.xml.tmpl with the same field reference corrections
- Added missing MSIX-related fields to BuildAssetsOptions struct (Publisher, ProcessorArchitecture, ExecutablePath, ExecutableName, OutputPath, CertificatePath)
- Set appropriate default values for the new fields in GenerateBuildAssets function
Resolves the error: "can't evaluate field Info in type commands.BuildConfig"
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixes Windows compilation error where iconIsInTrayBounds was being
assigned without declaration. Declares the variable explicitly
before assignment to resolve 'undefined: iconIsInTrayBounds' error.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Remove CLAUDE.md and API_MANAGERS.md files that were not intended
for this branch. The Windows compilation fixes remain intact.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixes two Windows-specific compilation issues that were preventing
GitHub Actions builds from passing:
## Issues Fixed
### 1. chromium.PutIsVisible undefined error
- **Problem**: Method call `chromium.PutIsVisible(true)` not available in
current go-webview2 package version
- **Solution**: Commented out the call with TODO note for future restoration
- **File**: pkg/application/webview_window_windows.go:1686-1690
- **Impact**: Temporarily disables efficiency mode prevention until method available
### 2. Variable redeclaration error
- **Problem**: `err` variable redeclared with `:=` in same function scope
- **Solution**: Changed second assignment from `:=` to `=` for proper reassignment
- **File**: pkg/application/systemtray_windows.go:65
- **Context**: iconIsInTrayBounds assignment in positionWindow function
## Additional Changes
- Added CLAUDE.md for development guidance
- Added API_MANAGERS.md documenting new manager-based API structure
- Implemented functional DMG package creation (internal/commands/dmg/)
- Restored DMG support in CLI tool with proper validation
## Verification
- ✅ Commands package builds successfully
- ✅ Main CLI builds successfully
- ✅ Tests run without compilation errors
- ✅ Example builds pass
Resolves GitHub Actions Windows build failures introduced in recent commits.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Addresses the issue where application windows fail to show on Windows 10 Pro
due to efficiency mode preventing WebView2 NavigationCompleted events.
## Changes Made
### Windows (webview_window_windows.go)
- **Decouple window container from WebView state**: Window now shows immediately
- **Add timeout fallback**: 3-second timeout to show WebView if navigation is delayed
- **Prevent efficiency mode**: Set WebView2 IsVisible=true per Microsoft recommendation
- **Enhanced state tracking**: Added showRequested, visibilityTimeout, windowShown fields
- **Robust navigation completion**: Improved handler to work with new visibility logic
### macOS (webview_window_darwin.go)
- **Documentation**: Added comment noting macOS already follows best practices
- **No functional changes**: macOS implementation already robust
### Linux (webview_window_linux.go, linux_cgo.go, linux_purego.go)
- **Add missing methods**: Implemented show()/hide() methods in main Linux file
- **CGO implementation**: Added windowShow()/windowHide() delegation methods
- **Purego implementation**: Added windowShow()/windowHide() methods for purego builds
- **Consistent behavior**: Matches CGO implementation with position saving
## Implementation Pattern
Adopts the following pattern:
1. **Separate concerns**: Window container vs WebView content readiness
2. **Immediate visibility**: Show window container immediately
3. **Progressive enhancement**: Show WebView content when ready
4. **Robust fallbacks**: Timeout and multiple strategies for edge cases
## Testing Considerations
- Windows 10 Pro efficiency mode scenarios
- WebView2 navigation delays or failures
- Cross-platform consistency
- Performance impact of timeout mechanisms
Fixes#2861🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Upgraded from v0.13.0 to v0.17.0 to get latest improvements
- Includes enhanced hardware detection capabilities
- Bug fixes for GPU path parsing and PCI address handling
- Verified wails doctor command continues to work correctly
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add UAC trustInfo section to Windows manifest template with default 'asInvoker' execution level
- Update badge example manifest to include UAC configuration
- Add comprehensive documentation for Windows UAC configuration
- Ensure consistent UAC behavior across different machines
Fixes issue where Windows applications lost admin requirements when copied between machines.
The UAC configuration is now always present in the manifest, making it explicit and easily
customizable by users since v3 expects users to edit their own build assets.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add badge_linux.go with no-op implementation for Linux compatibility
- Fix capabilities_linux.go to not require webkit version detection
- Add missing build tag to webkit_linux.go
Resolves "undefined: badge.NewWithOptions" and "undefined: badge.New" errors
that were causing Linux build failures in GitHub Actions for badge examples.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Update systray.mdx
GUI operations must run on the main thread I guess? this example calling systray.Run() from a non-main thread context and it will panic.
* Update systray.mdx
OnClick function takes *application.Context. the example if not complete
Serve runtime from assetserver if requested.
Add gin guide, fix asset server merge, add gin example
adding http.CloseNotifier and http.Flusher interface to assetserver.contentTypeSniffer, for Gin (and other framework) compatibility.
* Enable go1.24 tests
This reverts commit e38684e7885c9c7b5ad3f704ad500c39bbce7715.
* Testdata for go1.24
This reverts commit 7ed397dc452f420551dfdd05dfe0c6a7646b3ba4.
* Require go 1.24
* Update changelog
* Add test for omitzero
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* Add prepend and clear method to menus
* Document appending and clearing menus
* Add `Destroy()`
Add notes to documentation.
* Remove menu item from map when destroying
* Remove menu items from map when clearing
* Update v3/pkg/application/menu.go
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
* Minor updates
* Fix build error
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
* Rename predicates source file
* Overhaul and document type predicates
* Fix model collection logic for named types
* Fix map key type rendering
* Fix map creation code
* Fix rendering of structs that implement marshaler interfaces
* Fix type cycle detection to take type args into account
* Fix enum and typeparam field initialisation
* Improve unsupported type warnings
* Remove internal models file
* Deduplicate template code
* Accept generic aliases in static analyser
* Support new `encoding/json` flag `omitzero`
* Handle special cases when rendering generic aliases
* Update npm test dependencies
* Test class aliases and implicit private dependencies
* Test marshaler combinations
* Test map key types
* Remove bad map keys from unrelated tests
* Test service discovery through generic aliases
* Test generic aliases
* Test warning messages
* Disable go1.24 tests
* Update changelog
* Restore rendering of injected lines in index file
* Test directives
* Add wails:ignore directive
* Fix typo
* Move injections to the bottom of service files
* Handle errors from closing files
* Do not emit messages when services define only lifecycle methods
* Add internal directive for services and models
* Update changelog
* Fix error in service templates
* Test internal directive on services/models
* Fix error in index template
* Base testdata updates
* Testdata for class aliases and implicit private dependencies
* Testdata for marshaler combinations
* Testdata for map key types
* Testdata for bad map key fixes
* Add weakly typed enums aka alias constants
* Testdata for enum and typeparam field fixes
* Testdata for generic aliases
* Testdata for warning messages
* Testdata for directives
* Testdata for weakly typed enums
* Update binding example
* Update services example
* Remove go1.24 testdata
* Update cli doc
* Fix analyser tests
* Fix windows tests... hopefully
* go mod tidy on examples
* Update bindings guide
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* Fix and optimize content type sniffer
- Minimize copying and buffering
- Ensure it sniffs the full 512-bytes prefix
* Fix assorted warnings
* Cleanup error formatting
- Remove unnecessary formatting calls
- Fix invalid format strings
- Standardise logging calls
* Fix and optimize index fallback method
- Pass through non-404 responses correctly
- Do not buffer original response
* Test content sniffing and index fallback
* Update changelog
* Remove obsolete check
* Add safety checks in sniffer
* New ContextMenu API + example
* Remove redundant code
* ContextMenuData now returns a string.
New Menu guide.
* Update readme
* Update v3/pkg/application/context.go
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
* Add new menubar option
* Fix docs
---------
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
* Pass build flags to binding generator
* Update changelog
* Track variable dependencies using task labels
* Track JS/TS sources for binding generator
The `/wails:include` directive allows for the inclusion of additional JS/TS files in the generated bindings.
* Pass production var to frontend task
* Track binding generator output as source
* Fix generates pattern for frontend build task
* Fix typo in function `term.Warningf`
* Use facilities from `internal/term` in bindings command instead of `pterm`
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* Gather and document service API
* Update changelog
* Add NewServiceWithOptions
* Revert static analyser change
* Remove infinite loop in NewService[WithOptions]
* Fix compiler warning in bindings command
* Add test for NewServiceWithOptions
* Update changelog
* Fix service example
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* Add some clarifying comments
* Remove special handling of window parameters
* Improve internal method exclusion
* Add test for internal method exclusion
* Remove useless blank field from app options
This is a leftover from an older version of the static analyser. It should have been removed long ago.
* Remove redundant godebug setting
gotypesalias=1 is the default starting with go1.23
* Use new range for syntax to simplify code
* Remove generator dependency on github.com/samber/lo
* Ensure generator testing tasks do not use the test cache
* Rename cyclic types test
* Test for cyclic imports
* Fix import cycle between model files
* Sort class aliases after their aliased class
* Test class aliases
* Fix length of default value for array types
* Test array initialization
* Add changelog
* Update changelog
* Fix contrived marking technique in model sorting algorithm
* Update binding example
* Update test data
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* [v3] Update Templates (macOS Target Version and Linux aarch64 AppImage)
* Update changelog.mdx
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
OpenFileManager for opening with the native file manager and optional
file selection support
Closes#3197
Co-authored-by: Krzysztofz01 <krzysztof.zon2001@gmail.com>
* docs: fix tip
* update packages
* add showase
* add 3 showcases from v2
* mdx -> md
* add links page
* add templates page with a caution
* add a tip
* move desc up
* use X instead of twitter
* fix link
* Add clave
* add how to section
* init docs
* add few categories
* add more
* update home
* add blog
* update favicon
* fix few links and
* untouch
* untouch more
* add some icons
* add icons
* move ggetting started at the top and collapse the rest
* actually collapse
* format
* remove includes
* more format
* remove includes
* move assets
* add i18n
* fix i18n
* formatting
* order
* Prevent sidebar from making the page shake during load
* Prevent sidebar from making the page shake during load
* organize docs
* fix link
* expand a bit
* add credits page
* update all contributors file
* remove underlines
* add alternative
* use html
* lets get the first success build
* add latest entry
* remove example file
* fix examples
* more fixes
* fix grammar
* grammar
* remove dupes
* fix link
* grammar
* typo
* typo
* typo
* Logo update. Minor changes.
* update changelog
* update changelog
* rabbit is right
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* rework service.OnStartup to close applicatoin on error
CHANGELOG.md
fix index out of bounds potential
* os.Exit -> runtime.Goexit
* Revert to os.Exit
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* Support for linux deb,rpm,arch linux packager packaging
* remove optional tasks from linux:package task
CHANGELOG.md
* Update Taskfile.linux.yml
* Integrated nfpm into CLI.
Fixed task update.
* package tool fixes and add bundle name field
empty name guard
* add linux depdencies
* Add some docs
* Fixed tests. Updated task to latest.
* Update v3/internal/commands/tool_package.go
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
* Remove doctor references to nfpm
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Support linux systrays first click to open
- Convert event handling to switch statement for better readability
- Fix menu event handlers to properly trigger open/close callbacks
- Update click behavior to use doubleClickHandler for Activate
CHANGELOG.md
* bugfix: update version to support application.ServiceOptions
* [v3] docs: update changelog
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* Update nsis template
* Move app data into config.yml
* mac support
* Add FileAssociations application config option
Support `ApplicationOpenedWithFile` event on Windows
Add docs
* Add FileAssociations application config option
Support `ApplicationOpenedWithFile` event on Windows
Add docs
Add test project
* Update example & docs.
Fix show window bug.
* Fix window show event bug
* Update changelog
* Update nsis template
* Move app data into config.yml
* mac support
* Add FileAssociations application config option
Support `ApplicationOpenedWithFile` event on Windows
Add docs
* Add FileAssociations application config option
Support `ApplicationOpenedWithFile` event on Windows
Add docs
Add test project
* Update example & docs.
Fix show window bug.
* Fix window show event bug
* Update changelog
* [v3] actions: run in forks and also build v3/* or v3-* branches
* [v3] actions: don't fail fast in test build actions
* [v3] actions: update actions to node20
* [v3] actions: specify cache dependency path for setup-go
to get rid of warnings
* plugin handler and lifecycle
* rebase
* remove reflect
s
* remove Config and NewPlugin from plugin template
* Remove plugin manager, generation of plugin interface
* implement http handlers for services
remove log
trim path
prefix wails/services
* update plugine example
* Misc updates
* Ported plugins to services, rewritten example
* Added fileserver
* Update OnStartup and use a context for the application
* Rename PathPrefix to Route. Create docs.
* Use service config copy. Add Name to Service Options. Improve service generation.
* Use service config copy. Add Name to Service Options. Improve service generation. Update README
* Remove rogue db
* Update changelog.md
---------
Co-authored-by: Lea O'Anthony <lea.anthony@gmail.com>
* [linux] emit system specific event for theme change
Code was incorrectly emitting the `events.Common.ThemeChanged` event
instead of the OS Specific `events.Linux.SystemThemeChanged` event.
It is the reponsibility of the code in events_common_linux.go to map
it to the common variety.
* [linux] implement WindowDidMove
* [linux] implement debounce for WindowDidMove
* [example] listen for events.Common.WindowDidMove
* [windows] move WindowDidMove mapper outside of DnD guard
* WindowDidResize implementation
* windows: WindowDidResize
* chore: changelog update
* events.Common.WindowDidMove and events.Common.WindowDidResize
* Add proposal.
Reference Mac implementation
* Add windows support. Update proposal.
* Update example
* Rename Active->Enable,Inactive->Disabled. Ensure window can get controls back after hiding close on windows. Added guide. Updated example.
* Add ExStyle option for setting titlebar style.
* Fix linux builds
* Tidy up
* Expose `DefaultApplicationMenu`.
Add `FindByLabel` and `ItemAt` for finding menu items in a menu
* Add `Menu.RemoveMenuItem()`, `MneuItem.GetAccelerator()` and `MenuItem.RemoveAccelerator()`
* Remove `Update`
* Iterate when removing menu items
* Add `GetSubmenu()`
* Subject generator output to stricter TS linting
* Fix runtime support code typing
* Relax tsconfig for templates
* Update test data
* Update binding example
* Support variadic arguments and slice, pointer types
* Fix computation of type namespaces
* Improve comments and general formatting
* Set default values correctly for composite types
* Add templates for bindings
Additionally:
* fixes generation of tuple return type
* improves imports and namespacing in JS mode
* general cleanup of generated code
* Simplify import list construction
* Refactor type generation code
Improves support for unknown types (encoded as any) and maps (using
Typescript index signatures)
* Support slices with pointer elements
* Match encoding/json behaviour in struct parser
* Update tests and example
* Add tests for complex method signatures and json tag parsing
* Add test `function_multiple_files`
* Attempt looking up idents with missing denotation
* Update test data
* fix quoted bool field
* Test quoted booleans
* Delete old parser code
* Remove old test data
* Update bindgen flags
* Makes call by ID the default
* Add package loading code
* Add static analyser
* Temporarily ignore binding generation code
* Add complex slice expressions test
* Fix variable reference analysis
* Unwrap casts to interface types
* Complete code comments
* Refactor static analyser
* Restrict options struct usage
* Update tests
* Fix method selector sink and source processing
* Improve Set API
* Add package info collector
* Rename analyser package to analyse
* Improve template functions
* Add index file templates
* Add glue code for binding generation
* Refactor collection and rendering code
* Implement binding generator
* Implement global index generation
* Improve marshaler and alias handling
* Use package path in binding calls by name
* Implement model collection and rendering
* Fix wrong exit condition in analyser
* Fix enum rendering
* Generate shortcuts for all packages.
* Implement generator tests
* Ignore non-pointer bound types
* Treat main package specially
* Compute stats
* Plug new API into generate command
* Support all named types
* Update JS runtime
* Report dual role types
* Remove go1.22 syntax
* Fix type assertion in TS bindings
* encoding/json compliance for arrays and slices
* Ignore got files in testdata
* Cleanup type rendering mechanism
* Update JS runtime
* Implement generic models
* Add missing field in renderer initialisation
* Improve generic creation code
* Add generic model test
* Add error reporting infrastructure
* Support configurable file names
* Detect file naming collisions
* Print final error report
* New shortcut file structure + collision detection
* Update test layout and data
* Autoconfiguration for analyser tests
* Live progress reporting
* Update code comments
* Fix model doc rendering
* Simplify name resolution
* Add test for out of tree types
* Fix generic creation code
* Fix potential collisions between methods and models
* Fix generic class alias rendering
* Report model discovery in debug mode
* Add interface mode for JS
* Collect interface method comments
* Add interface methods test
* Unwrap generic instantiations in method receivers
* Fix rendering of nullable types in interface mode
* Fix rendering of class aliases
* Expose promise cancel method to typescript
* Update test data
* Update binding example
* Fix rendering of aliased quoted type params
* Move to strongly typed bindings
* Implement lightweight analyser
* Update test cases
* Update binding example
* Add complex instantiation test
* Load full dependency tree
* Rewrite collector
* Update renderer to match new collector
* Update generator to match new collector
* Update test data
* Update binding example
* Configure includes and injections by language
* Improve system path resolution
* Support rich conditions in inject/include directives
* Fix error handling in Generator.Generate
* Retrieve compiled go file paths from fileset
* Do not rely on struct info in struct flattening algorithm
* Fix doc comment for findDeclaraion
* Fix bugs in embedded field handling
* Fix bugs and comments in package collection
* Remove useless fields from ServiceInfo
* Fix empty line at the beginning of TS indexes
* Remove global index and shortcuts
* Remove generation tests for individual packages
* Enforce lower-case file names
* Update test data
* Improve error reporting
* Update binding example
* Reintroduce go1.22 syntax
* Improve relative import path computation
* Improve alias support
* Add alias test
* Update test data
* Remove no services error
* Rename global analyser test
* Add workaround and test for bug in typeutil.Map
* Update test data
* Do not split fully qualified names
* Update typeutil package and remove workaround
* Unify alias/named type handling
* Fix rendering of generic named class aliases
* Fix rendering of array types
* Minor tweaks and cleanups
* Rmove namespaced export construct
* Update test data
* Update binding example
* Break type cycles
* Fix typo in comment
* Fix creation code for cyclic types
* Fix type of variadic params in interface mode
* Update test data
* Fix bad whitespace
* Refactor type assertions inside bound methods
* Update test data
* Rename field application.Options.Bind to Services
* Rename parser package to generator
* Update binding example
* Update test data
* Update generator readme
* Add typescript test harness
* Move test output to new subfolder
* Fix code generation bugs
* Use .js extensions in TS mode imports
* Update test data
* Revert default generator output dir to frontend/bindings
* Bump runtime package version
* Update templates
* Update changelog
* Improve newline handling
---------
Co-authored-by: Andreas Bichinger <andreas.bichinger@gmail.com>
* webkitgtk4.0->webkitgtk4.1
changelog
* Update mkdocs-website/docs/en/changelog.md
* Update deps in pipeline
* Update deps in pipeline
* Install 4.1 only when v3
* Install 4.1 only when v3
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* Add `port` flag to dev command, ...
Add support for environment variable WAILS_VITE_PORT
* Check if port is already in use
* Update changelog
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* Unmarshal arguments to appropriate type in binding calls
* Marshal multiple return values to arrays in binding calls
* Improve logging of remote method calls
* Add tests for `BoundMethod.Call`
* Fix return value if error is nil
* Update changelog
---------
Co-authored-by: Andreas Bichinger <andreas.bichinger@gmail.com>
* allow for non-Window WailsEvent listeners
- adds a RegisterListener function on the App struct such
that code can listen for WailsEvent(s) even if it isn't a Window
- rename dispatchEventToWindows -> dispatchEventToListeners
- add all windows and WailsEventListeners to slice before emitting
* Update v3/pkg/application/application.go
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* Fix: #3270
removes an unnessecary check which returned a double nil wich in turned causes a crash if systray doesn't have an attached window.
* Add iconIsInFlyout method to systray_windows
and use it to determine if the icon is in the
flyout or not when positioning an attached window.
* optimize the windows systray window positioning
we only need to get the systray bounds if
the icon is in the flyout area.
* Use correct behavior for placing the window
if the systray icon is visible in the taskbar the
window should be centered on the systray icon
otherwise the icon is in a flyout are and the
window should be placed in the corner.
Added comments to explain placement logic
* consistent placing of systray menu on right vs left click
* add PR info in changelog
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* Fix appimage file sourcing
Add findGTKFiles to source webkit files for appimage generation
s
* Update refresh version to fix CPU usage
s
* update changelong
* refresh version up
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* Fix appimage file sourcing
Add findGTKFiles to source webkit files for appimage generation
s
* Update refresh version to fix CPU usage
s
* update changelong
`linux` suffix means it won't compile on non-Linux platforms.
Shorten the name to avoid:
../../pkg/application/options_webview_window.go:104:8: undefined: LinuxWindow
../../pkg/application/options_application.go:28:8: undefined: LinuxOptions
../../pkg/application/options_webview_window.go:104:8: undefined: LinuxWindow
* Fix computing 'startURL' when 'FRONTEND_DEVSERVER_URL' is present.
* Respect provided URL when computing 'startURL' and 'FRONTEND_DEVSERVER_URL' is present.
* Update changelog.
* Correctly produce absolute URI in 'GetStartURL' when input is provided.
Introduced the ability to clone a menu, along with its submenus, in Linux-based web applications to create a full deep copy. This fixes reusing the application menu for window menus.
This update introduces a LinuxOptions struct for Linux-specific application configurations and refines webview for Linux. The 'windows' map has been renamed to 'windowMap' to avoid confusion. Moreover, a method to unregister Windows has been added to ensure the Linux application automatically quits when the last window closes, unless explicitly disabled in the new LinuxOptions structure. Reset Window position after hiding. Some debug output has been removed.
The commit introduces a set of webview GPU policies to control hardware acceleration. These policies define when hardware acceleration is enabled on the webview. An option for this has been added to the LinuxWindow struct for Linux specific windows. Additional code modification was carried out to use this new GPU policy option when calling `windowNew` function. Finally, the sequence of the GPU Policies in the const declaration has been updated for better readability.
This commit includes the addition of common events for the Linux platform. Refactored and standardized the method receivers for the application from 'm' to 'l'. Also, the application startup events in the window example have been updated according to the new naming scheme.
Introduced the ability to clone a menu, along with its submenus, in Linux-based web applications to create a full deep copy. This fixes reusing the application menu for window menus.
This update introduces a LinuxOptions struct for Linux-specific application configurations and refines webview for Linux. The 'windows' map has been renamed to 'windowMap' to avoid confusion. Moreover, a method to unregister Windows has been added to ensure the Linux application automatically quits when the last window closes, unless explicitly disabled in the new LinuxOptions structure. Reset Window position after hiding. Some debug output has been removed.
The commit introduces a set of webview GPU policies to control hardware acceleration. These policies define when hardware acceleration is enabled on the webview. An option for this has been added to the LinuxWindow struct for Linux specific windows. Additional code modification was carried out to use this new GPU policy option when calling `windowNew` function. Finally, the sequence of the GPU Policies in the const declaration has been updated for better readability.
This commit includes the addition of common events for the Linux platform. Refactored and standardized the method receivers for the application from 'm' to 'l'. Also, the application startup events in the window example have been updated according to the new naming scheme.
* Add option for showing the toolbar in fullscreen mode on macOS
* Add an example demonstrating the ShowToolbarWhenFullscreen option
* Update docs
* Add changelog entry
* Run go mod tidy
* Add JS Window API example
* Add ToggleMaximise button to Window API example
* Restore ToggleMaximise method in Window interface
* Update docs and changelog
Three new options have been introduced in the application options for MacOS to disable the minimize, maximize, and close buttons on the window. Corresponding functionality has been added in the webview window for darwin to handle these new options. These changes have been showcased in the window example main.go file.
This commit introduces the functionality to disable the minimise and maximise buttons on windows. These options have been added to the `application.WebviewWindowOptions` and integrated in the Windows application logic. Effectively, developers can now control the availability of these buttons in their windows applications.
This update adds implementation to several menu item functions, replacing their previous 'not implemented' state. This includes actions for close, reload, forcing reload, toggling of fullscreen, reset zoom, and others. The update also includes modifications for the handling of developer tools toggle under different build configurations. This refactoring is aimed to standardize devtools configuration across different operating systems.
* Fix systray click handling
* Open Menu if no window is attached in defaultClickHandler()
* Remove systemTraySetMenu function
* Fix a crash in hide-window example
* Update changelog
The code update sets the default extension to the first pattern in the save dialog file filter when options.Filters is populated. This improvement applies to Windows platform interface function for 'Save File Dialog' and provides a more intuitive user experience.
This update allows the application shutdown to be cancelled. It implements the shouldQuit function, which can prevent the application from quitting if it returns false. Additional checks have been added to ensure cleanup and quit processes are performed only if required. The darwin delegate and linux and windows applications were modified to include this new functionality.
A new method OnShutdown was introduced to allow adding tasks to be run when the application shuts down. The shutdown tasks are run on the main thread and in the order they were added, with the application option `OnShutdown` being run first. This allows more controlled and managed shutdown of the application.
An option to disable AssetServer logging has been introduced in the application options. This will suppress every request log from the AssetServer if set to true. This adjustment is useful for preventing log saturation in certain scenarios or environments.
The application shutdown process has been significantly reworked to be more efficient and robust. The refactored code removes the event listener for the 'ApplicationTerminate' event. Instead, an in-process flag is added to the 'Quit' method to prevent recursive calls. Additionally, an optional 'OnShutdown' function variable is introduced to allow custom cleanup operations upon app termination.
This commit adds a robust teardown process for windows on application shutdown. It introduces a field to track the destruction state of each window and checks such before performing window operations. Also, it enhances the destroy functions within application for thorough clean up. Finally, redundant event handlers related to application termination were removed while fixing file generating challenge in go tasks.
Without this patch there's a really strange behaviour if there are
multiple windows.
Having two windows with a webview open with an input field.
Focusing the input field on one window, then focusing the input
field on the second one. Then clicking directly on the non client
area of the first one, e.g. to trigger a minimze, the minimize is
not executed until the mouse is getting moved. As long as the
mouse is not moved the event for the click is blocked and not
executed.
Using this new mode fixes that problem, but we need to handle
‘alt+f4’ on our own.
The frontend interaction has been significantly updated, including improvements to the Greet function and the addition of an ongoing time display. Additionally, dependencies in package.json have been updated to their latest versions. Also, redundant print statement was removed from messageprocessor_call.go and changes were made to layout structure and styles in the main.go.tmpl and index.html files.
The Wails runtime has been updated to correctly handle debug checks and the version in the package.json has been bumped to 3.0.0-alpha.6. Fixed reference to global wails object in WML.
* Add Taskfile entry for run:linux, used by task dev
Signed-off-by: Marcus Crane <marcus@utf9k.net>
* Add updated CHANGELOG entry
Signed-off-by: Marcus Crane <marcus@utf9k.net>
* Correct CHANGELOG entry
---------
Signed-off-by: Marcus Crane <marcus@utf9k.net>
* remove 'test' project
* dynamic template list generation
- uses a single fs.Embed to contain all templates
- walks and rebuilds the list of TemplateData using the cached data
- pulls the `description` out of the required `template.json` file in
the template directory
* [v3] template handling update
- move "common" template files to a _common directory
- update generator to render from _common/* first
- render selected template last to overwrite anything provided by
_common if needed
- remove duplicate files from all templates that do not change
* cleanup template project directory after test
* add linux to _common/Taskfile.yaml
* noop: whitespace cleanup _common/Taskfile.yaml
- use unsafe.Pointers for 'signal_connect'
- add handler for 'script-message-received::external'
need to update this to handle older versions of webkit2gtk better
currently removed the ifdef guards (since they don't work in Go code
directly) - need to reimplement using build tags if required.
* add check for GPU device info
* add changelog note
* change return to continue
* Small refactor
---------
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
- disable output of `import <model> from models` line
- update README to generate bindings in usable location for HTML
- update HTML to reference bindings correctly
- update javascript to call and process the bound Greet function
* Fixes doctor bug for apt package manager
* Actually fix it
* Pad the text " all"
Adding a space to ensure checking against "all" doesn't always catch "install" or "not-installed" etc
* Update changelog.md
Doctor Apt Verify
---------
Co-authored-by: atterpac <michael@atterpac.dev>
Co-authored-by: Lea Anthony <lea.anthony@gmail.com>
* [v3 linux/systray] dbus generation
* [v3 linux] systemtray dbus implementation
* [v3] add 'id' for MenuSeparator
This is needed in order to have a unique value for all
menuItem(s) such that the Linux implementation doesn't have to
generate new identifiers.
Allowing the reuse keeps a 1-1 mapping in place without any extra effort.
* [v3 example/systray] add radio group to example
* [v3 linux] stub out ExportStatusNotifierItem callbacks
Can only seem to get the `SecondaryActivate` to fire when doing a
3-finger click! I was expecting a right-click interaction to trigger it.
- drop the gtkSignalHandlers map entirely (wasn't used)
- use 'uint' for mapping signal IDs to MenuItem
- store and retrieve the menuitem identifier to/from the menu item widget
Linux requires a `gtk_menu_bar` for a gtk_window to display a menu.
For the `systray` a `gtk_menu` is needed instead.
This change creates the correct type of `impl` for the `Menu`
depending on how it is being used.
The constant x-wails-client-id is generated once on startup and then
sent with each request to the Wails host. It is used primarily by
the server plugin to distinguish different remote sessions.
- remove type assertions
- update contentTypeSniffer to capture the status code
- move logic in ServeHTTP to serveHTTP
- wrap serveHTTP with ServeHTTP adding logging & duration calculation
* [v2, darwin] Add "Hide, Hide Others, Show All“ to appmenu
This also includes shortcuts support for those commands.
Arrange the menu items in the well known MacOS order.
* [v2, darwin] Add Window menu with well known shortcuts Minimize, Full-Screen and Zoom.
This fixes some long-standing inconsistencies between
dev mode builds and production builds but is a breaking
change. Dev mode uses custom scheme for Vite versions >= 3.0.0
and for older it still behaves in the old way.
{"time":"2025-08-27T20:12:32.005147+10:00","level":"INFO","source":{"function":"github.com/charmbracelet/crush/internal/config.loadProviders","file":"/home/runner/work/crush/crush/internal/config/provider.go","line":113},"msg":"Getting live provider data"}
{"time":"2025-08-27T20:12:32.809775+10:00","level":"INFO","msg":"goose: successfully migrated database to version: 20250627000000"}
{"time":"2025-08-27T20:12:32.811691+10:00","level":"INFO","source":{"function":"github.com/charmbracelet/crush/internal/app.(*App).initLSPClients","file":"/home/runner/work/crush/crush/internal/app/lsp.go","line":18},"msg":"LSP clients initialization started in background"}
{"time":"2025-08-27T20:12:44.74985+10:00","level":"WARN","source":{"function":"github.com/charmbracelet/crush/internal/llm/tools.init.func1","file":"/home/runner/work/crush/crush/internal/llm/tools/rg.go","line":18},"msg":"Ripgrep (rg) not found in $PATH. Some grep features might be limited or slower."}
{"time":"2025-08-27T20:14:53.934325+10:00","level":"INFO","source":{"function":"github.com/charmbracelet/crush/internal/config.loadProviders.func1","file":"/home/runner/work/crush/crush/internal/config/provider.go","line":103},"msg":"Updating provider cache in background"}
{"time":"2025-08-27T20:14:54.434655+10:00","level":"INFO","msg":"goose: no migrations to run. current version: 20250627000000"}
{"time":"2025-08-27T20:14:54.434719+10:00","level":"INFO","source":{"function":"github.com/charmbracelet/crush/internal/app.(*App).initLSPClients","file":"/home/runner/work/crush/crush/internal/app/lsp.go","line":18},"msg":"LSP clients initialization started in background"}
{"time":"2025-08-27T20:17:34.718351+10:00","level":"WARN","source":{"function":"github.com/charmbracelet/crush/internal/llm/tools.init.func1","file":"/home/runner/work/crush/crush/internal/llm/tools/rg.go","line":18},"msg":"Ripgrep (rg) not found in $PATH. Some grep features might be limited or slower."}
}else if (result === 'fixed' && committed === 'true') {
message = '## 🔧 Changelog Updated\n\nMisplaced entries were automatically moved to the `[Unreleased]` section. The changes have been committed to this PR.';
}else if (result === 'fixed' || result === 'cannot_fix' || result === 'error') {
'@'+ author + ' Your PR contains changelog entries that were added to already-released versions. These need to be moved to the `[Unreleased]` section.\\n\\n' +
(committed === 'true' ?
'✅ **Auto-fix applied**:The changes have been automatically committed to this PR.' :
'<summary>📝 Click to see the corrected changelog content</summary>\\n\\n'+
'```mdx\\n'+
fixedContent +
'\\n```\\n\\n'+
'</details>\\n\\n'+
'**What happened?** \\n'+
'The validation script detected that you added changelog entries to a version section that has already been released (like `v3.0.0-alpha.10`). All new entries should go in the `[Unreleased]` section under the appropriate category (`### Added`, `### Fixed`, etc.).\\n\\n'+
(committed !== 'true' ? '**Action needed:** Please copy the corrected content from above and replace your changelog file.' :'');
# Trigger the workflow every time you push to the `main` branch
# Using a different branch name? Replace `main` with your branch’s name
push:
branches:[v3-alpha]
# Allows you to run this workflow manually from the Actions tab on GitHub.
workflow_dispatch:
# Allow this job to clone the repo and create a page deployment
permissions:
contents:read
pages:write
id-token:write
jobs:
build:
runs-on:ubuntu-latest
if:github.event.repository.fork == false
steps:
- name:Checkout your repository using git
uses:actions/checkout@v4
- name:Install, build, and upload your site output
uses:withastro/action@v2
with:
path:docs
node-version:20# The specific version of Node that should be used to build your site. Defaults to 18. (optional)
# package-manager: pnpm@latest # The Node package manager that should be used to install dependencies and build your site. Automatically detected based on your lockfile. (optional)
This document provides a comprehensive technical architecture for iOS support in Wails v3. The implementation enables Go applications to run natively on iOS with a WKWebView frontend, maintaining the Wails philosophy of using web technologies for UI while leveraging Go for business logic.
- **Asset Request**: < 10ms for cached, < 50ms for first load
- **JS Execution**: < 5ms for simple scripts
- **Message Passing**: < 2ms round trip
- **Memory Usage**: < 50MB baseline
- **Battery Impact**: < 2% per hour active use
### Monitoring
1. **Xcode Instruments**: CPU, Memory, Energy profiling
2. **WebView Inspector**: JavaScript performance
3. **Go Profiling**: pprof for Go code analysis
## Future Enhancements
### Phase 1: Core Stability
- [ ] Production-ready error handling
- [ ] Comprehensive test suite
- [ ] Performance optimization
### Phase 2: Feature Parity
- [ ] Multiple window support
- [ ] System tray integration
- [ ] Native menu implementation
### Phase 3: iOS-Specific Features
- [ ] Widget extension support
- [ ] App Clip support
- [ ] ShareSheet integration
- [ ] Siri Shortcuts
### Phase 4: Advanced Features
- [ ] Background task support
- [ ] Push notifications
- [ ] CloudKit integration
- [ ] Apple Watch companion app
## Conclusion
This architecture provides a solid foundation for iOS support in Wails v3. The design prioritizes battery efficiency, native performance, and seamless integration with the existing Wails ecosystem. The proof of concept demonstrates all four required capabilities:
1. ✅ **WebView Creation**: Native WKWebView with optimized configuration
2. ✅ **Request Interception**: Custom scheme handler without network ports
3. ✅ **JavaScript Execution**: Bidirectional communication bridge
4. ✅ **iOS Simulator Support**: Complete build and deployment pipeline
The architecture is designed to scale from this proof of concept to a full production implementation while maintaining the simplicity and elegance that Wails developers expect.
[](https://starlight.astro.build)
```sh
npm create astro@latest -- --template starlight
```
[](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics)
[](https://codesandbox.io/p/sandbox/github/withastro/starlight/tree/main/examples/basics)
[](https://app.netlify.com/start/deploy?repository=https://github.com/withastro/starlight&create_from_path=examples/basics)
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fwithastro%2Fstarlight%2Ftree%2Fmain%2Fexamples%2Fbasics&project-name=my-starlight-docs&repository-name=my-starlight-docs)
> 🧑🚀 **Seasoned astronaut?** Delete this file. Have fun!
## 🚀 Project Structure
Inside of your Astro + Starlight project, you'll see the following folders and
files:
```sh
.
├── public/
├── src/
│ ├── assets/
│ ├── content/
│ │ ├── docs/
│ │ └── config.ts
│ └── env.d.ts
├── astro.config.mjs
├── package.json
└── tsconfig.json
```
Starlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory.
Each file is exposed as a route based on its file name.
Images can be added to `src/assets/` and embedded in Markdown with a relative
link.
Static assets, like favicons, can be placed in the `public/` directory.
## 🧞 Commands
All commands are run from the root of the project, from a terminal:
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/bh90210"><imgsrc="https://avatars.githubusercontent.com/u/22690219?v=4?s=75"width="75px;"alt="Byron Chris"/><br/><sub><b>Byron Chris</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=bh90210"title="Code">💻</a><ahref="#research-bh90210"title="Research">🔬</a><ahref="#maintenance-bh90210"title="Maintenance">🚧</a><ahref="https://github.com/wailsapp/wails/issues?q=author%3Abh90210"title="Bug reports">🐛</a><ahref="https://github.com/wailsapp/wails/pulls?q=is%3Apr+reviewed-by%3Abh90210"title="Reviewed Pull Requests">👀</a><ahref="https://github.com/wailsapp/wails/commits?author=bh90210"title="Tests">⚠️</a><ahref="#question-bh90210"title="Answering Questions">💬</a><ahref="#ideas-bh90210"title="Ideas, Planning, & Feedback">🤔</a><ahref="#design-bh90210"title="Design">🎨</a><ahref="#platform-bh90210"title="Packaging/porting to new platform">📦</a><ahref="#infra-bh90210"title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/konez2k"><imgsrc="https://avatars.githubusercontent.com/u/32417933?v=4?s=75"width="75px;"alt="konez2k"/><br/><sub><b>konez2k</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=konez2k"title="Code">💻</a><ahref="#platform-konez2k"title="Packaging/porting to new platform">📦</a><ahref="#ideas-konez2k"title="Ideas, Planning, & Feedback">🤔</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://ianmjones.com/"><imgsrc="https://avatars.githubusercontent.com/u/4710?v=4?s=75"width="75px;"alt="Ian M. Jones"/><br/><sub><b>Ian M. Jones</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=ianmjones"title="Code">💻</a><ahref="https://github.com/wailsapp/wails/issues?q=author%3Aianmjones"title="Bug reports">🐛</a><ahref="#ideas-ianmjones"title="Ideas, Planning, & Feedback">🤔</a><ahref="https://github.com/wailsapp/wails/commits?author=ianmjones"title="Tests">⚠️</a><ahref="https://github.com/wailsapp/wails/pulls?q=is%3Apr+reviewed-by%3Aianmjones"title="Reviewed Pull Requests">👀</a><ahref="#platform-ianmjones"title="Packaging/porting to new platform">📦</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://codybentley.dev/"><imgsrc="https://avatars.githubusercontent.com/u/6968902?v=4?s=75"width="75px;"alt="Cody Bentley"/><br/><sub><b>Cody Bentley</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=codydbentley"title="Code">💻</a><ahref="#platform-codydbentley"title="Packaging/porting to new platform">📦</a><ahref="#ideas-codydbentley"title="Ideas, Planning, & Feedback">🤔</a><ahref="#financial-codydbentley"title="Financial">💵</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/Vaelatern"><imgsrc="https://avatars.githubusercontent.com/u/7906072?v=4?s=75"width="75px;"alt="Toyam Cox"/><br/><sub><b>Toyam Cox</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=Vaelatern"title="Code">💻</a><ahref="#platform-Vaelatern"title="Packaging/porting to new platform">📦</a><ahref="https://github.com/wailsapp/wails/issues?q=author%3AVaelatern"title="Bug reports">🐛</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/BillBuilt"><imgsrc="https://avatars.githubusercontent.com/u/28831382?v=4?s=75"width="75px;"alt="BillBuilt"/><br/><sub><b>BillBuilt</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=BillBuilt"title="Code">💻</a><ahref="#platform-BillBuilt"title="Packaging/porting to new platform">📦</a><ahref="#ideas-BillBuilt"title="Ideas, Planning, & Feedback">🤔</a><ahref="#question-BillBuilt"title="Answering Questions">💬</a><ahref="#financial-BillBuilt"title="Financial">💵</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/Juneezee"><imgsrc="https://avatars.githubusercontent.com/u/20135478?v=4?s=75"width="75px;"alt="Eng Zer Jun"/><br/><sub><b>Eng Zer Jun</b></sub></a><br/><ahref="#maintenance-Juneezee"title="Maintenance">🚧</a><ahref="https://github.com/wailsapp/wails/commits?author=Juneezee"title="Code">💻</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/Lyimmi"><imgsrc="https://avatars.githubusercontent.com/u/8627125?v=4?s=75"width="75px;"alt="Zámbó, Levente"/><br/><sub><b>Zámbó, Levente</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=Lyimmi"title="Code">💻</a><ahref="#platform-Lyimmi"title="Packaging/porting to new platform">📦</a><ahref="https://github.com/wailsapp/wails/issues?q=author%3ALyimmi"title="Bug reports">🐛</a><ahref="https://github.com/wailsapp/wails/commits?author=Lyimmi"title="Tests">⚠️</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/fallendusk"><imgsrc="https://avatars.githubusercontent.com/u/565631?v=4?s=75"width="75px;"alt="fallendusk"/><br/><sub><b>fallendusk</b></sub></a><br/><ahref="#platform-fallendusk"title="Packaging/porting to new platform">📦</a><ahref="https://github.com/wailsapp/wails/commits?author=fallendusk"title="Code">💻</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/lanzafame"><imgsrc="https://avatars.githubusercontent.com/u/5924712?v=4?s=75"width="75px;"alt="Adrian Lanzafame"/><br/><sub><b>Adrian Lanzafame</b></sub></a><br/><ahref="#platform-lanzafame"title="Packaging/porting to new platform">📦</a><ahref="https://github.com/wailsapp/wails/commits?author=lanzafame"title="Code">💻</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/alexmat"><imgsrc="https://avatars.githubusercontent.com/u/745421?v=4?s=75"width="75px;"alt="Alexander Matviychuk"/><br/><sub><b>Alexander Matviychuk</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=alexmat"title="Code">💻</a><ahref="#platform-alexmat"title="Packaging/porting to new platform">📦</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/AlienRecall"><imgsrc="https://avatars.githubusercontent.com/u/68950287?v=4?s=75"width="75px;"alt="AlienRecall"/><br/><sub><b>AlienRecall</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=AlienRecall"title="Code">💻</a><ahref="#platform-AlienRecall"title="Packaging/porting to new platform">📦</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/stankovic98"><imgsrc="https://avatars.githubusercontent.com/u/29852655?v=4?s=75"width="75px;"alt="Antonio Stanković"/><br/><sub><b>Antonio Stanković</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=stankovic98"title="Code">💻</a><ahref="#platform-stankovic98"title="Packaging/porting to new platform">📦</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/benjamin-thomas"><imgsrc="https://avatars.githubusercontent.com/u/1557738?v=4?s=75"width="75px;"alt="Benjamin Thomas"/><br/><sub><b>Benjamin Thomas</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=benjamin-thomas"title="Code">💻</a><ahref="#platform-benjamin-thomas"title="Packaging/porting to new platform">📦</a><ahref="#ideas-benjamin-thomas"title="Ideas, Planning, & Feedback">🤔</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/diogox"><imgsrc="https://avatars.githubusercontent.com/u/13244408?v=4?s=75"width="75px;"alt="diogox"/><br/><sub><b>diogox</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=diogox"title="Code">💻</a><ahref="#platform-diogox"title="Packaging/porting to new platform">📦</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/kyoto44"><imgsrc="https://avatars.githubusercontent.com/u/17720761?v=4?s=75"width="75px;"alt="Dmitry Gomzyakov"/><br/><sub><b>Dmitry Gomzyakov</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=kyoto44"title="Code">💻</a><ahref="#platform-kyoto44"title="Packaging/porting to new platform">📦</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/Jarek-SRT"><imgsrc="https://avatars.githubusercontent.com/u/3391365?v=4?s=75"width="75px;"alt="Jarek"/><br/><sub><b>Jarek</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=Jarek-SRT"title="Code">💻</a><ahref="#platform-Jarek-SRT"title="Packaging/porting to new platform">📦</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/fengweiqiang"><imgsrc="https://avatars.githubusercontent.com/u/22905300?v=4?s=75"width="75px;"alt="fengweiqiang"/><br/><sub><b>fengweiqiang</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=fengweiqiang"title="Code">💻</a><ahref="#platform-fengweiqiang"title="Packaging/porting to new platform">📦</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://github.com/OlegGulevskyy"><imgsrc="https://avatars.githubusercontent.com/u/43781031?v=4?s=75"width="75px;"alt="Oleg Gulevskyy"/><br/><sub><b>Oleg Gulevskyy</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=OlegGulevskyy"title="Code">💻</a><ahref="https://github.com/wailsapp/wails/commits?author=OlegGulevskyy"title="Documentation">📖</a><ahref="#maintenance-OlegGulevskyy"title="Maintenance">🚧</a><ahref="#platform-OlegGulevskyy"title="Packaging/porting to new platform">📦</a></td>
<tdalign="center"valign="top"width="12.5%"><ahref="https://sheetjs.com/"><imgsrc="https://avatars.githubusercontent.com/u/6070939?v=4?s=75"width="75px;"alt="Eric P Sheets"/><br/><sub><b>Eric P Sheets</b></sub></a><br/><ahref="https://github.com/wailsapp/wails/commits?author=SheetJSDev"title="Code">💻</a></td>