Habitat CompassHabitat Compass

Home › Guides › Tax planner

How to use the tax planner

The same functions feed the comparison pages and the report ledger. This page explains how to read them. It does not invent a second tax table.

Open the tax planner, pick a city, type an annual income in US dollars, and choose an income type. 48 countries with structured brackets accumulate tax band by band in local currency. Countries without brackets fall back to a rule approximation. Those two results are not the same confidence. The effective rate and the take-home figure are for comparison only. They are not tax advice and not a filing.

Where to start, and what to type

The static write-up is the tax planner page. To open the app on one city, use this Chiang Mai link (the city= parameter is the city id). The income box accepts 10,000 to 250,000 US dollars and clamps anything outside that range. The three types are remote employee, freelancer, and indie founder. The type changes the tax only when that country's record actually forks.

Brackets, approximations, citizenship, and days

Where bracket data exists, the page runs the progressive bands, including any threshold, standard deduction, and conditional concession already written in that profile. Where it does not, a regime rule supplies a coarse approximation. It does not invent a more precise rate. Whether a concession applies depends on visa class, tax residency, income type, and any cap. A low rate without those conditions is not an approval.

Local tax is converted to US dollars at the snapshot rate 2026-10. That month is not a rate-verification date. If you switch on US or Chinese citizenship and the country of stay is different, the planner adds a directional home-country top-up: credit only, no refund. If you are staying in that same country, the layer is absent. When one year is split across places, the day-split panel cuts the same income by days. For a country that taxes worldwide income, that split is often only a floor, not the bill on a full year of worldwide income.

Tax treaties, remittance rules, and municipal taxes are not modelled. This is not tax, legal, or immigration advice.

Open the tax planner page · Tax-free and territorial list · How to read the dates · Back to guides

FAQ

The three income types return the same number. Is that a bug?

Not by itself. Some country records do not split freelancer, employee, and founder. Identical results mean that profile has no fork by income type.

Is the FX month a tax-rate verification date?

No. 2026-10 is only used to convert local tax into US dollars for comparison. It is not a rate-verification date, and the page generation date is not one either.

Can I file from this page?

No. It does not model tax treaties, remittance rules, or municipal tax, and it does not replace a return. The figures are for a directional comparison between places.