Feel free to join and collaborate on our Discord Server.
⚠️ Please do not submitlocalizationrelated pull requests at this time. Once we are ready to support more languages we will let you know with a guide on how to contribute here and on our Discord Server.
Tap the "Fork" button on the top of the site. After forking clone the forked repository to your Mac.
Find issues from the Issues tab or from the To Do column in our project. If you find an issue you want to work on, please indicate it in the issue and/or attach a draft PR once available. An admin or maintainer will then assign the Issue and/or PR to you.
Please read the Getting Started guide in our wiki.
We also have a troubleshooting guide that provides common resolutions.
Please read our guide on Code Style in our wiki.
Once you are happy with your changes, submit a Pull Request.
The pull request opens with a template loaded. Fill out all fields that are relevant.
The PR should include following information:
- A descriptive title on what changed.
- A detailed description of changes.
- If you made changes to the UI please add a screenshot or video as well.
- If there is a related issue please add a reference to the issue. If not, create one beforehand and link it.
- If your PR is still in progress mark it as Draft.
Request a review from one of our admins @austincondiff, @lukepistrol, @MarcoCarnevali, @jasonplatts, @pkasila or maintainers @cstef, @linusS1, @RayZhao1998, @wdg.
Note: If it is your first PR, an admin will need to request a review for you.
Please resolve all
Violationerrors in Xcode (except: TODO: warnings). Otherwise the swiftlint check on GitHub will fail.
Once you submit the PR GitHub will run a couple of actions which run tests and SwiftLint (this can take a couple of minutes). Should a test fail, it cannot be merged until tests succeed.
Make sure to resolve all merge-conflicts otherwise the PR cannot be merged.
Important: make sure your code is well documented so others can interact with your code easily!