Contribute to FatturaFacile
FatturaFacile grows thanks to people who work on it in their spare time: developers, students, accountants, translators and testers. Every bit of help counts, however small.
What you can do
Six ways to help
Code
New features and fixes for the API (Laravel), web (Angular), desktop (.NET) and mobile (Flutter).
Testing and bug reports
Try the demo and open an issue when something doesn't work or isn't clear.
Translations
Review the Italian, English, French and German of the application and of this website.
Documentation
User guides, READMEs and wiki pages for newcomers.
Design and UX
Logo, icons, screenshots and small interface improvements.
Tax regulations
Accountants and fiduciaries: checking FatturaPA, QR-bill and VAT rates.
How we work
From issue to release
The same workflow for every repository. Automated checks (lint, tests and build) run on every pull request.
- 1
Pick an issue
Start from an open issue (the "good first issue" ones are a good start) or open a new one, and mention it in the Telegram group.
- 2
Create a branch
Organisation members work on a branch of the repository; everyone else uses a fork.
- 3
Open a pull request
Against the dev branch (on repositories that have one, otherwise main), with a clear description of what changes and why.
- 4
Review
At least one approval and green checks are required. After the merge, the changes show up in the development environment.
- 5
Release
When dev is stable it moves to main; versions are released with a tag (vX.Y.Z).
Repositories
Where the code lives
- web-apiLaravel · PHP · PostgreSQLBusiness API: business logic, e-invoicing and REST API.
- web-frontendAngular · TypeScriptThe web application, the one you use in the demo.
- desktop.NET · WPF · SQLiteWindows app for working offline with a local database.
- mobileFlutter · DartApp for iOS and Android.
- websiteAstro · Tailwind CSSThis website, in 4 languages.
- FatturaFacileWiki · GitHub ActionsCentral repository: roadmap, wiki and shared workflows.