Thanks for contributing to Wave.
This project is maintained as a personal-use native macOS app. Contributions should prioritize simple, reliable behavior and minimal UI/UX friction.
- Open
Wave.xcodeprojin Xcode - Select scheme
Wave - Press Run — this builds the Debug configuration, which installs as Wave (Debug) and uses bundle ID
io.monawwar.wave.debug
If you have the production Wave app installed, quit it first to avoid hotkey and audio tap conflicts.
- Dictation reliability (hotkey -> record -> transcribe -> paste)
- Lightweight native UX
- Safe single-instance behavior
- Clear onboarding and settings behavior
AI-assisted contribution is welcome. If you use AI tools:
- Keep prompts specific to this codebase and file paths.
- Ask AI for incremental changes, not large rewrites.
- Verify all generated code manually before committing.
- Build and run the app after changes.
- Confirm no regressions in:
- global shortcut capture
- overlay status behavior
- text paste flow
- onboarding/state persistence
When proposing AI-generated changes, include:
- what files changed
- what behavior changed
- how you validated locally
When submitting changes, keep notes concise:
- Problem being solved
- Implementation summary
- Validation steps run