History

doxa-maps-88655c70 2509a6e347 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 README: three outputs, not five methods; a Languages section; screenshot gates see every shot again - Deployment is now organised around what the build makes: (1) one web folder (536 files, 76 MiB), embedded by iframe and JavaScript (proven) and WordPress (just for fun); (2) the mobile app (Capacitor, built); (3) the desktop app (Tauri, proof of concept). A hosting table says where the folder can go: dx-life's public/, Cloudflare Pages drag-and-drop (fits its 1,000-file / 25 MiB limits), GitHub + jsDelivr (JS embeds only: measured, jsDelivr serves HTML as text/plain), or any web server, with the one _headers line JS embeds need. No Docker. The diagram and the map-cruncher picture say three outputs. - Languages: 11 locales via ?lang=, Arabic right to left, with an Arabic shot of UPG-100 (Big Picture still leaks English in Arabic; reported). The partner profile-config locale is deliberately not documented until it is fixed. - check-shot-freshness and check-shot-distinctness parsed only '...' paths, so after `44ef31b2` turned them into `/${TREE_NAME}/...` templates they saw 2 of 26 shots: distinctness failed, freshness passed vacuously and hid 22 stale shots. Both now accept either form and resolve TREE_NAME, and exit 75 (NOT MEASURED) unless every `await shot(` call is parsed (the one dynamic dx-life call is marked). Negative-tested. The 22 shots are retaken and checked by eye. - how-to: the shell no longer overwrites the Studio (it now lives in the output folder); README serve line points at doxa-maps/index.html. - Docs follow the rename to dx-maps (`09014f8a`): every output-folder path and URL in README, how-to, reference, CONTRIBUTING, the CLI section and the develop guide now says public/dx-maps/. The repo name, the config file name, the WordPress plugin folder and the doxa-* tag names are unchanged (tags are a separate landing). - Hosting: a live example, the dx-life branch research-gallery, which drops the folder into dx-life public/ and fills /research with the Research Gallery.		2026-09-25 19:40:03 +00:00
..
architecture	Research Gallery: embed on someone else's page, in both modes	2026-09-24 19:03:37 +00:00
assets	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
contributing	README: lead with the objectives, showcase the Research Gallery, teach the agent swarm	2026-09-24 18:34:02 +00:00
readme-images	README: three outputs, not five methods; a Languages section; screenshot gates see every shot again	2026-09-25 19:40:03 +00:00
screenshots	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
CONTRIBUTING.md	README: three outputs, not five methods; a Languages section; screenshot gates see every shot again	2026-09-25 19:40:03 +00:00
develop-a-plugin-and-see-it-live.md	README: three outputs, not five methods; a Languages section; screenshot gates see every shot again	2026-09-25 19:40:03 +00:00
explanation.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
how-to.md	README: three outputs, not five methods; a Languages section; screenshot gates see every shot again	2026-09-25 19:40:03 +00:00
README-embed-example.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
README-SECTION-3-cli-commands.md	README: three outputs, not five methods; a Languages section; screenshot gates see every shot again	2026-09-25 19:40:03 +00:00
README.md	README: lead with the objectives, showcase the Research Gallery, teach the agent swarm	2026-09-24 18:34:02 +00:00
reference-capability-exemplars.md	Rename the output folder to dx-maps	2026-09-25 19:26:14 +00:00
reference-library-index.md	Merge main into bundler-1/work (regenerate the tree, re-hash)	2026-09-24 05:33:32 +00:00
reference.md	README: three outputs, not five methods; a Languages section; screenshot gates see every shot again	2026-09-25 19:40:03 +00:00
tutorial.md	Docs: every build line a reader copies now carries BUILD_ALLOW=1	2026-09-25 03:07:52 +00:00
vendored-font-noto-serif-devanagari.md	Move the vendored font's README out of the served folder	2026-09-24 04:15:26 +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.

Working on the repo:

develop-a-plugin-and-see-it-live.md — ★ the golden path: zero to a plugin live, in 6 steps.
README-SECTION-3-cli-commands.md — every command, per deployment method, with prerequisites.
reference-capability-exemplars.md — which bundle is at which capability tier (generated).
reference-library-index.md — the reusable library/ pieces you can import (generated).
CONTRIBUTING.md and contributing/ — how to contribute, and the bar for library/.

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