📈 GH Trending Explorer 🎲 Surprise me

← all repos

Alaa-Taieb / map-tunisia

git clone https://github.com/Alaa-Taieb/map-tunisia.git

The most accurate open-source SVG maps of Tunisia: country, regions, districts, 24 governorates, 279 delegations & 2,083 imadas · 5 levels of detail · 8 modes · SVG, GeoJSON, TopoJSON

—
stars, 24h
+75
stars, 7 days · #665
+75
stars, 30 days · #3,000
75
★ total · +75% this week
11
forks · 0 open issues

Star history starts 2026-10-20; the chart appears after the second daily snapshot.

LanguageJavaScript
License—
Created2026-10-17 (3d ago)
Last push3d ago
Watchers2
OwnerUser

GitHub topics

Links

README excerpt
The most accurate open-source SVG maps of Tunisia 
Country · 7 economic regions · 5 districts · 24 governorates · 279 delegations · 2,083 imadas 
5 levels of detail · 8 visual modes · SVG · GeoJSON · TopoJSON · العربية · Français · English
**🧭 Live explorer** ·
**⬇️ Download** ·
**⚡ Quick start** ·
**📚 Docs** ·
**✅ Accuracy report**
---
## Why Map Tunisia?
Most Tunisia SVGs online are hand-traced, outdated, missing islands, or stop at the 24 governorates. Map Tunisia is built
from **OpenStreetMap**, the most precise open source of Tunisian boundaries, and cross-checked against official INS and ISIE
lists. The result is a complete, exactly nested set of maps that you can drop into any project.
### 🎯 Accurate
- Real coastline at full precision, with **every island**: Djerba, Kerkennah, La Galite, Zembra, Kuriat…
- **0 km² of gaps or overlaps**: every level is cut from one planar topology
- Land area within **0.08 %** of the CIA World Factbook
- **Every correction** to the raw data is documented with its source
### 🧩 Complete
- **6 nested partitions**, down to the 2,083 *imadas*
- **All 279 delegations** of the 2024 census, including the 14 created since 2014, which no other open dataset has
- The **2023 districts** (Decree 2023-589) and the **7 economic regions**
- **2014 & 2024 census population** built in
### 🛠️ Ready to use
- **8 modes**: plain, outline, light, dark, Latin labels, Arabic labels, nested borders, interactive
- **5 levels of detail**, from 1 m precision to 17 KB icons
- Semantic ids (**ISO 3166-2**, **INS codes**) and `data-*` attributes in 3 languages
- GeoJSON + TopoJSON + CSV, a **lon/lat → SVG** helper, and an explorer
## 🖼️ Gallery
**Six partitions, exactly nested**
**Eight modes**
**Five levels of detail** (Djerba, at the same zoom)
 More examples : labelled maps in both scripts, dark delegations, nested sectors 
 governorates · medium · labeled 
 governorates · medium · labeled-ar 
 delegations · low · dark 
 delegations · medium · nested 
## ⚡ Quick start
**1. Use a file directly.** Every SVG scales to any size:
 [code] 
**2. Inline it and style it with CSS.** Every shape has an `id` and `data-*` attributes:
 [code] 
**3. Add behaviour with a few lines of JavaScript:**
 [code] 
**4. Place your own points.** All SVGs share one frame (UTM 32N, 1 unit = 1 km):
 [code] 
**More recipes** for React, D3 + TopoJSON, Leaflet, MapLibre, Python (GeoPandas, Plotly), R, QGIS, Figma, print and laser cutting are in the **usage guide**.
## ⬇️ Download
Every file lives in `dist/` and follows one naming scheme:
 [code] 
| Popular file | Size |
| --- | ---: |
| Governorates, labelled · Arabic | 135 KB |
| Governorates, interactive | 135 KB |
| Delegations, light | 446 KB |
| Sectors (imadas), nested | 1.8 MB |
| Country outline, for icons | 4 KB |
| Governorates TopoJSON · GeoJSON | 105 KB · 306 KB |
Browse every combination in the **file catalog** or the **live explorer**,
or grab everything with **Download ZIP**.
For JavaScript projects: `n