From 692b25e1f5fe4de0b4efe3f77b5f4100ed6602ad Mon Sep 17 00:00:00 2001 From: doxa-maps Date: Fri, 11 Sep 2026 22:05:23 +0000 Subject: [PATCH] docs: slide-deck outline (BLUF hand-off pitch) from the handoff distillate --- docs/slide-deck-outline.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 docs/slide-deck-outline.md diff --git a/docs/slide-deck-outline.md b/docs/slide-deck-outline.md new file mode 100644 index 000000000..9070e04de --- /dev/null +++ b/docs/slide-deck-outline.md @@ -0,0 +1,33 @@ +# doxa-maps — slide deck outline (BLUF; hand-off pitch) + +> One slide = one gold nugget. Bottom line up front, then facets. Real product names named. +> Keep the itch words: JAMstack · SPA · embed on thousands of partner sites. + +1. **Title** — "doxa-maps — a JAMstack bundler for composable, embeddable-first maps." + Sub: build once, embed on thousands of partner sites, or ship as an app. Authored agent-first. +2. **The bottom line** (the whole pitch on one slide) — One build step outputs every map as a + self-contained web component with its own HTML page → embed anywhere, compose into a + single-page app, or wrap as iOS/Android. [pipeline diagram from README] +3. **The problem** — 10 partner sites, 3 bad options (rebuild per site / iframe farm / framework + lock-in). Change once → redo ten times. +4. **The answer: map islands** — one file, drops in like an image, host needs no framework or + build step. [hero diagram] +5. **One build, three products** — embeds · SPA (the power app) · mobile. Same bundles. +6. **Proof it's portable** (the WordPress story) — the whole site changed frameworks; the map + moved with a few-line wrapper, zero refactor. Migration-proof by design. +7. **JAMstack = future-proof** — front end moves anywhere; swap the back end (or map engine + Mapbox↔MapLibre) with no rebuild. Live: partners get new maps on reload. +8. **Fast & lean** — one inlined file (Vue+CSS), tree-shaken, one request; faster than Vue-CDN. +9. **The one rule** (the entire learning curve) — non-reusable code stays in your app-profile; + only proven components graduate to the shared library. Follow it → maps never break each other. +10. **Built for agents** — connect your agent → dev server → staging of every map → feedback → + one build. "Built by agentic engineers, for agentic engineers." (aka vibe coders.) +11. **The mission fit** — prayer maps embedded on partner sites; MapLibre = token-free, no single + point of failure across thousands of embeds; posters + prayer packets print from one codebase. +12. **Where it thrives** (the pairing, not a dependency) — decoupled by design; pair with an + internal developer platform (MCP onboarding, multi-tenant, CI/CD) and the multiplication + compounds. Standalone today; exponential paired. +13. **The stack** (name the real products) — Vite · Bun · Vue web components · MapLibre/Mapbox · + Capacitor · Forgejo (source-control-as-CDN). No lock-in — un-closable primitives. +14. **Try it / take it** — the repo, the docs (why → tutorial → how-to → reference → architecture), + the live staging playground. Deep-dive: point your agent at docs/architecture/.