meshcore-regions

Canonical, community-editable catalog of MeshCore regions used worldwide.

What this is

A simple JSON catalog of region identifiers used across the MeshCore ecosystem. Each region has a stable code (e.g. de-hh-attraktor or hansemesh), a human-readable name (the leaf label, e.g. Attraktor), and optional nested children. A region's code never changes once published, even if it gets re-nested under a different parent.

How to consume

Two stable raw URLs:

• Full catalog (tree + flat lookup): https://raw.githubusercontent.com/marcelverdult/meshcore-regions/main/index.json
• One country at a time: https://raw.githubusercontent.com/marcelverdult/meshcore-regions/main/regions/<code>.json

Each region node has this shape:

{
  "code": "de-hh-attraktor",
  "name": "Attraktor",
  "regions": [ /* same shape, optional */ ]
}

code is stable and unique across the catalog. It usually mirrors the path from the root (e.g. de-hh-attraktor), but named networks that span multiple parents may keep a standalone code (e.g. hansemesh nested under de). The flat array in index.json lists every node as { "path": "<code>", "name": "<name>" } for quick lookups; path equals the node's code.

How to contribute

Pull requests may only modify files matching:

• regions/*.json
• unsorted/todo.json

Anything else (scripts, workflows, schemas, index.json, README.md) is maintained by repository maintainers via direct commits.

Rules enforced automatically by CI:

• No new country root files. PRs may not add files to regions/. The 249 ISO country codes plus sco and ioi are already seeded; if you need another root, open an issue.
• No deletions in regions/. Once a region is in the tree, it stays.
• Moves require approval. If your PR moves a node from one parent to another, a maintainer adds the approved-move label before merge.
• Subdivision additions and name edits are free. Add subdivisions under existing parents, fix a display name — no label needed.
• Codes are lowercase ASCII letters, digits, and hyphens. Each hyphen-separated segment is capped at 29 characters to match the MeshCore firmware region-name buffer (char name[31] in RegionMap.h, minus one byte reserved for the implicit # prefix the firmware prepends when deriving auto-hashtag transport keys; see meshcore-dev/MeshCore#2434). A region's code is immutable — once published, it does not change, even if the node is re-nested under a different parent.
• Children of any node are sorted by code.

How sync works

The catalog refreshes every night from the public MeshCore map at http://map.kiekr.app. Two ways to add a new region:

• Pin your repeater on the map with the KiekR App for Android or iOS (https://kiekr.app); your region appears here on the next sync.
• Open a pull request against this repository.

Last updates

• Last sync: 2026-10-28T09:11:00Z
• Roots: 252
• Total nodes: 2704
• Unsorted entries: 1240

when (UTC)	kind	path	note
2026-10-27T08:32:49Z	sync	62539cb	Merge pull request #139 from marcelverdult/sync/auto
2026-10-27T08:32:39Z	sync	4b75769	sync: 6 added, 0 resolved, 1232 unsorted
2026-10-26T08:21:11Z	sync	3a47ee4	Merge pull request #138 from marcelverdult/sync/auto
2026-10-26T08:21:02Z	sync	d81ffa0	sync: 2 added, 0 resolved, 1229 unsorted
2026-10-25T07:59:25Z	sync	1450c43	Merge pull request #137 from marcelverdult/sync/auto
2026-10-25T07:59:17Z	sync	36ec47a	sync: 4 added, 0 resolved, 1226 unsorted
2026-10-24T07:47:47Z	sync	d793012	Merge pull request #136 from marcelverdult/sync/auto
2026-10-24T07:47:40Z	sync	2ef2169	sync: 4 added, 0 resolved, 1218 unsorted
2026-10-23T08:09:21Z	sync	a061e25	Merge pull request #135 from marcelverdult/sync/auto
2026-10-23T08:08:50Z	sync	5e08630	sync: 5 added, 0 resolved, 1216 unsorted
2026-10-22T08:19:44Z	sync	3a899fc	Merge pull request #134 from marcelverdult/sync/auto
2026-10-22T08:11:06Z	sync	b18f7ce	sync: 7 added, 0 resolved, 1215 unsorted
2026-10-21T08:11:05Z	sync	1aff1af	Merge pull request #133 from marcelverdult/sync/auto
2026-10-21T08:10:16Z	sync	0e2eedf	sync: 6 added, 0 resolved, 1215 unsorted
2026-10-20T08:05:37Z	sync	b2c099c	Merge pull request #132 from marcelverdult/sync/auto
2026-10-20T08:04:44Z	sync	3f2ee9c	sync: 5 added, 0 resolved, 1213 unsorted
2026-10-19T18:45:15Z	sync	b85fad5	Merge pull request #131 from marcelverdult/sync/auto
2026-10-19T18:43:04Z	sync	48172d2	sync: 0 added, 0 resolved, 1206 unsorted
2026-10-19T18:42:43Z	sync	0fceaf7	Merge pull request #130 from marcelverdult/sync/auto
2026-10-19T18:42:35Z	sync	a522774	sync: 14 added, 0 resolved, 1206 unsorted

License

CC0 1.0 Universal — public-domain dedication. This catalog is released with no rights reserved: copy, modify, redistribute, and embed it (including in firmware) for any purpose, with no attribution required.