History

swift-river542 12d1fee133 Some checks are pending Deploy to GitHub Pages / build (push) Waiting to run Details Deploy to GitHub Pages / deploy (push) Blocked by required conditions Details Public build folder is three entries: index.html, assets/, doxa-maps/ - index.html is generated by internal/generate-spa.mjs from doxa-maps/manifest.json: one self-contained page that lists every bundle, profile and instance, mounts the chosen one, and offers Open page / Copy embed; build ends with `bun run spa` (the material shell is no longer installed; nav.js, icons.js, languages.js, pane-wrapper/, external/ and _headers leave public/) - The website drop-in follows the same contract: dropin.include in the build config, sync-dropin --from-config --prune, public-hygiene --strict fails on any other root entry - Production bundles no longer carry CSS comments: a build-only Vite plugin strips them from every shadow-style block (about 140 per map bundle, 5% smaller); remaining comments reworded - Share pages and the pin renderer drop their note-style comments		2026-09-16 18:23:14 -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
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	Public build folder is three entries: index.html, assets/, doxa-maps/	2026-09-16 18:23:14 -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

README.md

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.