f0798a675e
BUILD-FIELD-RESOURCE-CARD. For the catalyst standing with the group on a phone. Seeing ONE group used to cost the engine, the world boundaries, the basemap tiles and the 2.3 MB pin index before a single link appeared. ?card=<slug> renders the group's sheet alone — no engine, no boundaries, no tiles, no pin index. Measured from the served files: the map transfers 7,942 KB plus a ~700 KB engine and unbounded tiles; the card transfers 678 KB worst case, of which 661 KB is the bundle itself and 17 KB the largest shard. 92% fewer bytes before tiles are counted at all. The bundle is now the floor, and splitting it is a separate job I have not done. SHARDED BY A STABLE HASH, after two measured failures: first two letters of the slug gave a 120 KB worst shard because every "Deaf <people>" lands in "de"; three letters left 110 KB because those slugs all begin "dea". djb2 low byte gives 255 even shards, mean 9 KB, max 17 KB, and the leaf recomputes the key so there is no index and one request. The identical function lives in both files: if either drifts the card 404s rather than serving somebody else's group. Flat filenames, card-<key>.json, because internal/generate-tree.mjs stages tables/*.json as files and throws EISDIR on a subdirectory — shared build machinery, not mine to change for one plugin. Share uses navigator.share where it exists (it offers whatever the catalyst already has) and falls back to the clipboard, with a cancelled share treated as the non-event it is. The link carries doxa.life's own slug, so what arrives reopens this card rather than a search — the slug now reaches the sheet from a tapped pin too, so sharing works from the map as well. Honesty unchanged: 1,738 cards carry something in the group's own language, 369 carry nothing and say so with the way in. Checked 400 roster rows resolve to a card, 0 missing; a tier-0 and a tier-2 card both carry what they should. |
||
|---|---|---|
| .. | ||
| boundaries | ||
| brand | ||
| external-bundles | ||
| fonts | ||
| glottolog | ||
| images | ||
| internet | ||
| legacy/upg-neighbor | ||
| people-groups | ||
| posters | ||
| pplr | ||
| tables | ||
| vendor | ||
| README.md | ||
data/ — the bundler's source-of-truth data
The law: data lives here; public/ is generated. public/ holds only the output folder
(public/<tree>/, named by name in vite.doxa-maps-build-config.json) and a generated README. The
build (internal/generate-tree.mjs) copies what the plugins FETCH at runtime from here into
<tree>/assets/, alongside the per-profile data in plugin-designs/*/data/. You should be able to
rm -rf public/ and get it all back with bun run build.
| Folder | Served at | What it is |
|---|---|---|
people-groups/ |
<tree>/assets/people-groups/ (the fetched cuts only) |
People-group datasets (CSV/JSON) the maps read at runtime |
vendor/ |
<tree>/assets/vendor/ |
Third-party runtime assets (e.g. table libraries) |
posters/ |
<tree>/assets/posters/ (opt-in: bundlePosters / posterSources) |
Rendered poster set (heavy pipeline output; the export button fetches these) |
tables/ |
<tree>/assets/tables/ |
The MERGED served table set (its index.json is the merge; per-profile plugin-designs/*/data/tables are build-time sources) |
pplr/ |
<tree>/assets/pplr/ (the fetched files only) |
The PPLR data maps' derived datasets |
fonts/ |
<tree>/assets/fonts/ |
Vendored typefaces (SIL OFL), e.g. Bebas Neue for the regions clone |
images/ |
<tree>/assets/images/ |
Images the plugins fetch (e.g. the regions list's world-map watermark; see its PROVENANCE) |
brand/ |
not served | Logos and brand imagery (sources; the optional library/layouts/app-wrapper-material shell references them) |
legacy/ |
not served | Archived standalone builds kept for reference (e.g. the original upg-neighbor page) |
external-bundles/ |
not served | Prebuilt map IIFEs vendored from sibling projects (not built here); only the optional layouts/ shell mounted them |
fonts/, images/, brand/ and legacy/ moved here from public/assets/ on 2026-09-25 (card
BUILD-OUTPUT-IS-ONE-FOLDER): they were sources that existed only in the generated folder.
Don't edit anything under public/ by hand — change it here (or in plugin-designs/*/data/,
layouts/*/assets/) and rebuild.