Help & Documentation
Learn how to use the salary calculator and understand how it works
- Select a country from the dropdown menu
- Choose the tax year for your calculation
- Enter your gross annual salary in the local currency
- Fill in any required inputs (e.g., filing status, region)
- Optionally select a tax variant (e.g., expat regime)
- View the detailed breakdown of taxes and contributions
- Add more countries to compare side-by-side (up to 4)
- Share your comparison with the shareable URL
Config-Driven Tax Calculations
Each country's tax rules are defined in YAML configuration files. These configs describe a directed acyclic graph (DAG) of calculations that process your inputs to produce the final net salary.
Calculation Flow
- Start with your gross annual salary
- Calculate taxable income (after deductions)
- Apply progressive tax brackets to determine tax owed
- Calculate social contributions (pension, healthcare, etc.)
- Apply tax credits to reduce final tax bill
- Compute net income: Gross - Taxes - Contributions + Credits
Tax Rates Explained
- Effective Rate: Average tax rate on your total income (total tax / gross income)
- Marginal Rate: Tax rate on your next earned amount (shows what percentage of a raise you'll keep)
The calculation engine is pure TypeScript with no framework dependencies, allowing it to run efficiently in Cloudflare Workers. All configs are validated with test vectors to ensure accuracy.
Australia
1 variant available
Bulgaria
Canada
13 variants available
Denmark
1 variant available
France
Germany
Ireland
1 variant available
Italy
2 variants available
Japan
Netherlands
2 variants available
New Zealand
Norway
1 variant available
Portugal
1 variant available
Singapore
South Korea
1 variant available
Spain
1 variant available
Sweden
1 variant available
Switzerland
United Arab Emirates
United Kingdom
United States
This project is open-source and community-driven. Your contributions help make accurate tax information accessible to everyone.
Ways to Contribute
- Add tax configurations for new countries
- Update existing configs when tax laws change
- Report calculation errors or bugs
- Improve documentation and help content
- Add test vectors to validate accuracy
- Enhance UI/UX and accessibility
Getting Started
Visit our GitHub repository for detailed contribution guidelines, setup instructions, and documentation on how to create tax configurations.
View on GitHubThis calculator provides informational estimates only and does not constitute tax, legal, or financial advice. Tax laws are complex, vary by jurisdiction, and are subject to change. Individual circumstances significantly affect final tax liability. Always consult a qualified tax professional or accountant for your specific situation before making financial decisions.