Contributing

We welcome contributions to rootfont. Here's how to get involved.

Ways to Contribute

• Report bugs — Open an issue with version info, steps to reproduce, and expected vs actual behavior
• Suggest features — Open a discussion in the Discussions tab
• Submit code — Fix bugs or implement features via pull request
• Improve docs — Help clarify or expand documentation
• Translate — Add or improve localizations

Development Setup

1. Fork the repository on GitHub
2. Clone your fork locally
3. Ensure Xcode 15+ and Swift 6.0+ are installed
4. Run swift build to verify the project compiles
5. Run swift test to confirm tests pass
6. Install git hooks: bash scripts/install-git-hooks.sh

Pull Request Guidelines

• Keep PRs focused — one feature or fix per PR
• Follow existing code style and conventions
• Add tests for new functionality
• Update localization strings if you add UI text
• Run python3 scripts/check-l10n.py before submitting
• Ensure CI passes (swift build, swift test, localization check, version check)

Reporting Bugs

When opening an issue, include:

• rootfont version and build (from About → Copy Version)
• About → Copy System Info output
• swift --version and xcode-select -p
• Steps to reproduce
• Expected vs actual behavior

Code of Conduct

This project follows the Contributor Covenant. Please be respectful and inclusive in all interactions.