Skip to content

Contributing

OpenTodoList is free and open source software. You can use it, study the source code, build it yourself, and contribute improvements.

The project exists because it is useful to its users and because it is still fun to build. If you like the app, there are several ways to help.

Report Issues And Ideas

If you found a bug or have an idea for a new feature, open an issue in the GitLab issue tracker.

Clear reports help a lot. Include the platform, app version, what you expected, what happened instead, and steps to reproduce the issue if possible.

Translate

Translations are managed through POEditor. You can help directly in the browser, even if you do not want to work on the code.

Improve The Documentation

Documentation is part of the project too. Fixing unclear wording, adding missing steps, or updating screenshots can make the app easier to try for the next person.

When adding images or videos, keep the files small enough that the docs stay pleasant to clone and browse. Normal screenshots should ideally stay below about 500 KB. Prefer PNG, JPEG, or WebP for still images, and prefer WebM or MP4 over large animated GIFs.

Release-post media is usually archival: once a release post is published, its images should rarely change. Generic screenshots, such as app store or overview screenshots, may be refreshed as the interface evolves and are better candidates for Git LFS. Large binary assets that are updated as whole files, such as bundled fonts, should also use Git LFS.

Contribute Code

The source code is hosted on GitLab. Fork the project, make your changes, and open a merge request when you are ready.

For build setup details, see Build From Source.

Contributions of time, testing, translations, and code are already enough. If you still want to support the project financially, you can use one of these options: