Thank you for your interest in contributing to Organic Maps (OM)!
There are many ways to contribute and OM needs a variety of talents: programmers, graphic designers, translators, UI/UX experts, etc.
See https://organicmaps.app/donate/
The simplest way to contribute is to submit an issue. Please give developers as much information as possible: OS and application versions, list of actions leading to a bug, a log file produced by the app.
When using the OM app on a device, use the built-in "Report a bug" option: on Android it creates a new e-mail with a log file attached. Your issue will be processed much faster if you send it to bugs@organicmaps.app.
If you have some ideas or want to request a new feature, please start a discussion thread.
OM is available in 35 languages already, but some of them are incomplete and existing translations need regular updates as the app evolves. See translations instructions for details.
We strive to have a functional, cohesive and pleasant to the eye map rendering style. There is always something to improve, add new map features, fine tune colors palette etc. And every time we add a new map feature/POI we need a good and free-to-use icon.
See styles and icons instructions for details.
Please follow instructions in INSTALL.md to set up your development environment and check the developer's guidelines. You will find a list of issues for new contributors here to help you get started with simple tasks.
All contributions to Organic Maps repository should be submitted via Github pull requests and signed-off with the Developers Certificate of Origin.
Each pull request is reviewed by OM maintainers to ensure its quality. Sometimes the review process even for smallest commits can be very thorough.
When contributing to this project, you must agree that you have authored 100% of the content, that you have the necessary rights to the content and that the content you contribute may be provided under the project license.
To contribute you must assure that you have read and are following the rules stated in the Developers Certificate of Origin (DCO). We have borrowed this procedure from the Linux kernel project to improve tracking of who did what, and for legal reasons.
To sign-off a patch, just add a line in the commit message saying:
Signed-off-by: Some Developer somedev@example.com
Git has a flag that can sign a commit for you. An example using it is:
git commit -s -m 'An example commit message'
Use your real name or on some rare cases a company email address, but we disallow pseudonyms or anonymous contributions.
The OM community abides by the CNCF code of conduct.
- Directories structure
- C++ Style Guide.
- Java Style Guide.
- Objective-C Style Guide.
- Pull Request Guide.
- How to write a commit message.
For any questions about developing OM and relevant services - virtually about anything related, please contact us, we'll be happy to help.