Thanks for your interest in contributing! Here's how to get started.
- Fork the repo and clone your fork
- Create a branch for your work:
git checkout -b feature/your-feature - Make your changes
- Test thoroughly on macOS 14+
- Submit a pull request
- Swift & SwiftUI only — No UIKit, no Objective-C unless absolutely necessary
- Follow existing patterns — Match the code style and architecture already in the project (MVVM, services layer)
- No third-party dependencies — Keep it lean. If you need something, build it or justify the dependency in your PR
- Target macOS 14+ — Don't use APIs unavailable on Sonoma
- Keep PRs focused — one feature or fix per PR
- Write a clear description of what changed and why
- Include screenshots for UI changes
- Make sure it builds with no warnings
- Check existing issues before opening a new one
- Bug reports: include macOS version, steps to reproduce, and expected vs actual behavior
- Feature requests: describe the use case, not just the solution
- Bug fixes
- UI/UX improvements
- Support for additional launchd keys in the editor
- Better log viewing (live tail, filtering)
- Accessibility improvements
- Performance improvements
- Adding third-party dependencies without strong justification
- Major architecture changes without prior discussion
- Features that require elevated privileges (sudo) without a clear security model
Be kind. Be constructive. We're all here to make a useful tool.