מפת היישובים המזכים בהטבת מס הכנסה - an interactive map of every Israeli locality whose residents are eligible for the periphery income-tax credit ("yishuvim mutavim", Section 11 of the Income Tax Ordinance), covering tax years 2016-2026.
Live: https://taxmap.nx1xlab.dev
Part of the NXTools Collection by NX1X.
- All 536 eligible localities on one map, color-coded by credit rate (7%-20%)
- Full benefit history per locality (rate + annual income cap, 2016-2026)
- Search (Hebrew and English names), filters by tax year, sector (Jewish / Arab / Druze / mixed), region, sub-region (Upper & Lower Galilee, Western Galilee, Golan, Gaza Envelope, Western & Eastern Negev, Eilat & Arava, Jordan Valley and more), local authority, and credit rate
- Benefit calculator, side-by-side comparison (with CSV / JSON export), changes-vs-last-year map mode, nearest-locality with a locate button, and a data & trends view
- Sharing (WhatsApp / Telegram / X / copy) for the whole site and per locality;
per-locality permalinks (
/yishuv/<slug>) - Hebrew (RTL) and English (LTR) interface, light and dark themes
- Accessibility: WCAG 2.1 AA-oriented - keyboard navigation, screen-reader support, accessibility menu (text size, high contrast, reduced motion, underlined links), full text list alongside the map
- Shareable URLs - filters and language are reflected in query parameters
An offline data pipeline turns the Tax Authority booklets into
localities.json, which is committed to the repo. On push to main,
Cloudflare Workers Builds runs the Vite build (with per-locality prerendering)
and deploys a single Cloudflare Worker that serves the static SPA and proxies
Web Analytics and the version check first-party. Editable source:
design/architecture.drawio.
Source of truth is the Israel Tax Authority's annual deduction booklets
(data-sources/data-after-filter/tax-map-<year>.pdf), joined with the CBS
locality registry:
data-sources/data-after-filter/tax-map-*.pdf
│ scripts/extract_pdf.py (pdftotext + table parsing, 2016-2026)
▼
data/raw/<year>.json {name, code, rate, cap}
│ scripts/build_data.py (join with the newest data/cbs/bycode*.xlsx,
│ ITM→WGS84 via pyproj, sector/sub-region,
▼ manual overrides in data/overrides.json)
public/data/localities.json one record per locality, benefits keyed by year
Rebuild the dataset (requires the pdftotext binary from poppler-utils):
pip install --require-hashes -r scripts/requirements.txt
npm run dataNotes baked into the data:
- 2023 amendment-256 localities (Tiberias, Akko, Sakhnin, Tamra and other
Galilee localities) carry the mid-year rate change as an
altentry. - Eilat is included with its separate benefit under the Eilat Free Trade Zone Law (10%, income produced in the Eilat region only).
- Newly founded localities missing from the CBS file (Ramat Trump, Aduraim,
Yonadav, Kedem Arava, Bitron) are geocoded via OSM/Wikipedia in
data/overrides.json.
npm install
npm run dev # local dev server
npm run build # production build to dist/
npm run preview # serve the production buildStack: Vite, vanilla JS, Leaflet. Basemaps: Israel Hiking Map (Hebrew) and CARTO Voyager (English). No backend - the site is fully static.
The site is fully static, so both Cloudflare targets work. Workers is the default here because the first-party analytics proxy (below) needs a small Worker script; on Pages the same can be done with a Pages Function.
- Workers (configured in
wrangler.jsonc, usessrc/worker.js). Deployed by Cloudflare Workers Builds, which pulls this repository and builds on push tomain; no deploy credentials are stored in GitHub. Manual deploy:npm run build && npx wrangler deploy. Requires Node 22 (see.nvmrc). - Pages: build command
npm run build, output directorydist. Without a Function, drop the analytics proxy and use Cloudflare's automatic Web Analytics injection instead.
Security headers and caching are configured in public/_headers.
Privacy-friendly, cookieless, and served first-party so ad/script blockers do
not strip it and the CSP stays at 'self':
- In the Cloudflare dashboard, add a Web Analytics site and copy its token (a public site token, safe to expose).
- Build with it set:
CF_ANALYTICS_TOKEN=xxxx npm run build. The beacon is injected into the HTML pointing at/cf/beacon.js;src/worker.jsproxies both the beacon script and its reporting endpoint (/cf/rum) to Cloudflare. - With no token set, nothing is injected. No third-party requests are made.
Found a mistake in the data? Open a
data error issue or use
the contact form. See
CONTRIBUTING.md for development setup. The source PDFs are
available in data-sources/.
- Israel Tax Authority deduction booklets - eligible-locality lists
- CBS locality file - names, codes, districts, population, coordinates
- Kol Zchut - eligibility conditions
- OpenStreetMap contributors and CARTO - base maps
This site is an independent reference tool, not tax advice, and is not affiliated with any government body. The binding text is the Tax Authority's publications.
Code licensed under the Apache License 2.0.