doxa-maps/library
Doxa Maps 19e699a174
Some checks are pending
Deploy to GitHub Pages / build (push) Waiting to run
Deploy to GitHub Pages / deploy (push) Blocked by required conditions
Doxa Maps — public snapshot
Seven production prayer/mission maps + the Plugin Studio, built as
compiled Vue custom elements: 5 plugin capabilities x 5 deployment
methods. One build emits the whole drop-anywhere doxa-maps/ tree; see
README.md and documentation/.
2026-09-24 03:45:19 +00:00
..
api Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00
colors Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00
components Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00
composables Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00
constants Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00
data Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00
i18n Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00
layouts Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00
maps Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00
scripts Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00
stores Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00
styles Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00
utils Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00
index.js Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00
ProfileLoader.vue Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00
README.md Doxa Maps — public snapshot 2026-09-24 03:45:19 +00:00

library/ (@map) — the shared map template

The other half of the architecture (see ../plugin-designs/README.md): every map in plugin-designs/<your-map>/ composes the reusable, parameterized pieces that live here. Fix something here and every map benefits on the next build; break something here and every map breaks — read components/WARNING.md before touching shared pieces.

Folder What lives there
ProfileLoader.vue The root of every bundle: parses profile-config, loads the profile, provides the stores + config
components/ Shared UI — map, legends, controls, popup (PeopleGroupDetail), tables, charts, hints (README)
composables/ Shared logic — map engine (useMapInstance), provider switch, shadow-DOM styles, theming
stores/ Per-instance Pinia stores (ui / map / data) — provided by ProfileLoader, injected by children
api/ Data-source registry (sources.json) + fetch layer — the JAMstack runtime wiring
colors/ Color sets maps opt into via profile-config.colorSet
i18n/ The shared string catalogs (all maps speak the same languages)
data/ Small shared datasets baked at build time (big served data lives in ../data/)
constants/ Shared constants
scripts/ Maintainer pipelines (posters, research) — not part of any bundle

The rule of thumb (same as WARNING.md): custom code in your app-profile, reusable code here — and things only move from the first to the second once they've earned it.