Thanks for your interest in contributing! Here's how to get started.
- Clone the repo
- Run
swift buildto compile - Grant Accessibility permissions to
.build/debug/AeroOverlayin System Settings
swift build # Debug build
swift build -c release # Release buildAfter building, restart the app to test changes:
pkill -f AeroOverlay; .build/debug/AeroOverlay &- Keep PRs focused on a single change
- Test on your machine before submitting
- Describe what changed and why
- Include your macOS version and AeroSpace version
- Screenshots help for UI issues
- Steps to reproduce are appreciated
- Follow existing conventions in the codebase
- No third-party dependencies — keep it lightweight