History

doxa-maps-88655c70 10567371e3 Some checks are pending build-gate / build (push) Waiting to run Details README: map-cruncher hero, cross-origin deploy certification shots, repo tree The three hand-off README items the definition-of-done still listed: (1) the map-cruncher hero -- an honest ASCII flow of the product's whole argument (many maps -> one library -> one build -> five targets); (2) the two 2026-09-24 certification screenshots showing the ENTIRE cap-5 app rendering on a foreign host page via iframe and via JS embed, with the host-page contract note (window.MAP_TOKEN + CORS); (3) an annotated repo tree naming the free zone, the shared @map zone and its high bar, and what the build output is.		2026-09-24 02:00:00 +00:00
..
architecture	Document why a gate cannot import plugin source, and stop teaching public binds	2026-09-22 17:40:11 +00:00
assets	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
contributing	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
readme-images	README: map-cruncher hero, cross-origin deploy certification shots, repo tree	2026-09-24 02:00:00 +00:00
screenshots	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
CONTRIBUTING.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
develop-a-plugin-and-see-it-live.md	Point the golden-path doc at the self-test of the golden path	2026-09-23 10:19:40 +00:00
explanation.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
how-to.md	Land the swarm's work: no iframes anywhere, a tree that keeps its shape, deeper facets	2026-09-22 14:51:52 +00:00
README-embed-example.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
README-longform.md	Say which embed targets we actually verified, and which we only expect to work	2026-09-23 05:33:51 +00:00
README-SECTION-3-cli-commands.md	Run the verification chain in phases instead of one long queue	2026-09-23 20:57:13 +00:00
README.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
reference-capability-exemplars.md	Give nested ProfileLoader children the profile-config they require	2026-09-22 09:37:35 +00:00
reference-library-index.md	Galaxy style on MapLibre, and restore both dashboard resizes	2026-09-23 20:35:38 +00:00
reference.md	Fix the same broken token command in reference.md, and say only what was measured	2026-09-23 04:13:45 +00:00
slide-deck-outline.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
tutorial.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
why.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00

README.md

documentation/ — 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.