History

Doxa Maps 7058e868eb README: show Rudder running as a desktop app Output 3 showed only the map app as a desktop app. Rudder is the desktop example the README describes, and it has now been built with `bun run desktop:build rudder-voice` and run on Linux: a screenshot of the running app goes under the map app's, with one line on how to build it. The PNG carries no text chunks (the original recorded its creation time and timezone); the pixels are unchanged.		2026-09-29 01:32:16 +00:00
..
architecture	Delete useMapPacket.js: nothing imports it since both packets print through the shared HTML renderer	2026-09-28 06:44:14 +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
needs-eyes	The partner-embed check becomes something a person can open	2026-09-26 00:47:12 +00:00
readme-images	README: show Rudder running as a desktop app	2026-09-29 01:32:16 +00:00
screenshots	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
CLOUD-DEVELOPMENT-ENVIRONMENT.md	A laptop that follows the table says when it needs credentials, and the last main defaults say development	2026-09-29 00:59:14 +00:00
CONTRIBUTING.md	CONTRIBUTING: source and build output as two commits in one push (not two pushes), with the two exemptions	2026-09-28 13:05:56 +00:00
DEPLOY.md	The table is development and main is production: the joining page, DEPLOY and the laptop sync follow it	2026-09-29 00:59:13 +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	Decouple prose: no go-base / nuxtbase / nuxtinator / doxa-base names in plugin comments and docs	2026-09-26 17:28:45 +00:00
HOWTO-build-the-desktop-app.md	bun run desktop:build <plugin> packages a desktop plugin as an app; check:targets keeps non-web plugins out of the web build	2026-09-28 06:44:14 +00:00
HOWTO-join-the-table.md	A laptop that follows the table says when it needs credentials, and the last main defaults say development	2026-09-29 00:59:14 +00:00
HOWTO-which-gates-need-a-browser.md	documentation: the browser guard, and ask the repo rather than grepping	2026-09-28 09:07:30 +00:00
PRESET-PLUGIN-STANDARD.md	A preset keeps its profile's defaults: instance props merge over the meta config instead of replacing it	2026-09-28 03:12:45 +00:00
README-embed-example.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
README-embed-gospel-resources.md	The map learned to name peoples, not just their languages	2026-09-27 02:40:12 +00:00
README-SECTION-3-cli-commands.md	Docs: an iframe updates itself; a script embed's integrity hash pins the bytes, so re-copy it after each release	2026-09-26 02:07:14 +00:00
README.md	The embed contract, written down for partners	2026-09-26 17:24:55 +00:00
reference-capability-exemplars.md	Regenerate the library index and the capability exemplars	2026-09-28 14:53:59 +00:00
reference-library-index.md	Regenerate the library index: the three packet charts and the items that landed uncatalogued	2026-09-28 15:01:26 +00:00
reference-universal-props.md	List names speak the reader's language: listLabel and listDefinition	2026-09-26 08:39:52 +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
THIRD-PARTY.md	Doc audit: five stale claims a newcomer would have acted on	2026-09-28 03:40:55 +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
vendored-fonts.md	Every vendored font ships its own licence	2026-09-28 01:30:47 +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.
README-embed-gospel-resources.md — the gospel map's URL contract for partner embeds: bring your own ISO 639-3 list, one country, one group, or the zero-access view.

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.