doxa-maps/docs
swift-river542 4874e48ab7 Add the prayer-focus-map preset element: the simple prayer map with one tab, dark chrome, opening on Africa
New bundle app-profiles/prayer-focus-map registers <prayer-focus-map>. The profile is imitated from doxa-simple-map; only named parameters changed: the initial view (center/zoom) and the chrome theme are read from profile-config, and the share table points at this bundle's preset page.

Preset table prayer-focus-map.instances.json (row africa) builds to its own standalone embed page; the manifest, the gallery and every bundle's staging page pick it up from the rebuild.

docs: cold hand-off friction log with the ranked list of doc fixes it surfaced.
2026-09-16 19:52:20 -05:00
..
architecture Host-agnostic share links, token-endpoint chain, dev playground as reusable modules, share/asset gates, validated profile-type vocabulary 2026-09-16 12:10:38 -05:00
assets README: lead with the SPA-composition trinity + visual proof (desktop & mobile) 2026-09-16 00:17:45 +00:00
explanation.md docs: add why.md — problem-first 'map islands' concept page (Vite/Astro/Stencil pattern); wire into front doors + playground link 2026-09-11 18:50:31 +00:00
handoff-test-2026-09-16.md Add the prayer-focus-map preset element: the simple prayer map with one tab, dark chrome, opening on Africa 2026-09-16 19:52:20 -05:00
how-to.md Docs reconciled with shipped reality: MapLibre on main, search opt-in documented 2026-09-16 03:05:53 +00:00
README-embed-example.md docs: simple README template for the embedded (in-host) copy 2026-09-11 18:50:31 +00:00
README.md docs: close retest gaps — engine-swap recipe (provider param), instances.json recipe + schema, adopt embed-example into router 2026-09-11 18:50:31 +00:00
reference.md Website drop-in destination is public/embed/doxa-maps-build 2026-09-16 18:42:15 -05:00
slide-deck-outline.md docs: slide-deck outline (BLUF hand-off pitch) from the handoff distillate 2026-09-11 22:05:23 +00:00
tutorial.md docs: fix cold-read gaps — embeddability design doc (generated pages + manifest), SPA recipe + PROFILES contract, copy-rename checklist 2026-09-11 18:50:31 +00:00
why.md README: lead with the story — one sign-up site is the bottleneck, the map embeds on every partner team's site, Training-for-Trainers roles, the share-button campaign, private CRM for the team list 2026-09-16 12:34:59 -05:00

docs/ — pick your path

        "what is this?"          "teach me"        "how do I …?"       "look it up"      "all the detail"
             │                       │                   │                  │                  │
         why.md  ──────────►  tutorial.md  ────►  how-to.md  ────►  reference.md  ───►  architecture/
        (2 min, 1 diagram)   (first map)         (task recipes)     (tables)           (contracts)
  • why.md — the problem and the "map islands" idea. Start here.
  • tutorial.md — build your first map, no jargon.
  • how-to.md — recipes: embed, iframe, SPA, colors, CDN, mobile, tokens.
  • reference.md — config fields, build scripts, the profile-config contract.
  • explanation.md — the model in 15 lines.
  • architecture/ — the deep end: full contracts, the per-file catalog.
  • README-embed-example.md — the drop-in README used when this bundler is embedded inside a host repo.

Nothing on the simple path is longer than a few minutes; everything complex lives in architecture/, linked from where you'd need it.