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

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.

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.

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.

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 sync: 2026-06-29T04:31:18Z
• Roots: 252
• Total nodes: 1407
• Unsorted entries: 437

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.