Contributing to PureMac

April 8, 2026 ยท View on GitHub

Thanks for your interest in contributing to PureMac.

Getting Started

  1. Fork the repo
  2. Clone your fork: git clone https://github.com/YOUR_USERNAME/PureMac.git
  3. Install prerequisites: brew install xcodegen
  4. Generate the Xcode project: xcodegen generate
  5. Open in Xcode: open PureMac.xcodeproj

Development

  • PureMac is built with SwiftUI and targets macOS 13.0+
  • Project structure is defined in project.yml (XcodeGen)
  • Run the app from Xcode with Cmd+R

Pull Requests

  • Keep PRs focused on a single change
  • Test your changes on at least macOS Ventura (13.0)
  • Follow existing code style
  • Update the README if your change affects user-facing behavior

What to Contribute

  • Bug fixes
  • New cleaning categories
  • Performance improvements
  • UI/UX enhancements
  • Localization (translations)
  • Documentation improvements

Reporting Bugs

Open an issue using the Bug Report template. Include:

  • macOS version
  • PureMac version
  • Steps to reproduce
  • Expected vs actual behavior

Feature Requests

Open an issue using the Feature Request template. Describe:

  • What you'd like to see
  • Why it would be useful
  • Any alternatives you've considered

Code of Conduct

Be respectful and constructive. We're all here to make Mac maintenance easier for everyone.