Contribute to FlatFree
Help us build the open repository that open source deserves.
Ways to Contribute
FlatFree is a community project, and every contribution helps. Here's how you can get involved:
Submit an Application
Have a free software Flatpak that deserves a home? Submit it to FlatFree. Automated malware scan + quality checks, then it's in.
Report Issues
Found a bug in the website, the repo infrastructure, or an application? Open an issue on GitHub and help us improve.
Write Code
Help us improve the website, tooling, and infrastructure. Pull requests are always welcome for any aspect of the project.
Spread the Word
Tell other developers about FlatFree. Share it on social media, mention it in community forums, blog about it. The more people know, the stronger our community grows.
Submitting an Application
You can use our flatfree-submit CLI tool to validate and prepare your submission from the terminal, or follow the steps below:
Submitting manually is straightforward:
- Fork the FlatFree repository on GitHub.
- Create a directory named after your app's reverse-domain ID (e.g.,
org.example.MyApp). - Add a flatpak-builder manifest:
org.example.MyApp.jsonororg.example.MyApp.yml. - Open a pull request.
Our automated CI validates the manifest, builds the app, and runs a malware scan. If all checks pass, it's accepted — no human reviewers needed.
Helping with the Repository
The FlatFree repository itself needs maintenance and improvement. Here are some ways to help:
- Improve the website. Our documentation and site can always be better. Help us write clearer guides, better CSS, or add new features.
- Review pull requests. While we don't have a formal review process, community members who spot issues in submission PRs are encouraged to comment.
- Build infrastructure. Help us set up automated build pipelines, repository signing, or better hosting for the Flatpak remote.
- Write tests. Help ensure that submitted manifests are valid and that applications build correctly.
Spread the Word
The most impactful thing you can do for FlatFree is to tell others about it. Many developers with AI-assisted projects don't even know they might be rejected from Flathub. Help us reach them:
- Share FlatFree on social media, forums, and community chat platforms.
- Mention FlatFree when you see discussions about Flathub's AI policy.
- Write blog posts about why open repositories should be truly open.
- Star the GitHub repository to help others discover it.
Join the Community
FlatFree is more than just a repository — it's a statement about what open source should be. By contributing, you're helping to build a future where free software distribution is truly free, without arbitrary restrictions on how code is created.
Every contribution matters, no matter how small. Whether you're submitting an application, fixing a typo in the documentation, or just telling a friend about FlatFree — you're making a difference.