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 destinations to compare side-by-side (up to 8)
- 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
3 variants available
Austria
1 variant available
Bulgaria
Canada
26 variants available
Denmark
2 variants available
Finland
1 variant available
France
2 variants available
Germany
Greece
1 variant available
Hong Kong
Ireland
2 variants available
Italy
2 variants available
Japan
1 variant available
Mexico
1 variant available
Netherlands
3 variants available
New Zealand
1 variant available
Norway
2 variants available
Poland
3 variants available
Portugal
2 variants available
Singapore
South Korea
2 variants available
Spain
2 variants available
Sweden
2 variants available
Switzerland
United Arab Emirates
United Kingdom
1 variant available
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.