doxa-maps/plugin-designs/demo-map/src
doxa-maps-88655c70 4d773d6ee8
Some checks are pending
Deploy to GitHub Pages / build (push) Waiting to run
Deploy to GitHub Pages / deploy (push) Blocked by required conditions
Move internal files out of the repo; fix five dead links; a fuller delegation diagram
Moved out (kept outside the repo, in the team's internal tracker):
- AGENT-BRIEF.md: operating rules for the team's own agents
- documentation/slide-deck-outline.md, documentation/README-longform.md:
  internal pitch material; the README and why.md cover the same ground
- plugin-designs/gospel-resources/SOURCES-CHECKED-AND-REJECTED.md: research log
- .claude/ (an editor status line), .forgejo/ (a CI workflow that never ran),
  _archive/ (a retired staging page; already gitignored but still tracked)
Seven code comments that named these files now describe the rule instead.

Fixed five dead links left from the docs/ -> documentation/ move, including
the one in template-bundle that every new plugin inherits.

The delegation diagram now shows the whole model: the Plugin Studio with the
shared library and the merge queue into main, seven production plugins with
capability badges and the Experimental shelf, one agent per plugin (a roaming
agent for the shelf), the shepherd's oversight ring, a legend, and the five
ways a build ships.
2026-09-25 05:14:10 +00:00
..
api consolidate docs into documentation/ and deployment shells into deployment/ 2026-09-21 23:23:23 +00:00
colors Move internal files out of the repo; fix five dead links; a fuller delegation diagram 2026-09-25 05:14:10 +00:00
components consolidate docs into documentation/ and deployment shells into deployment/ 2026-09-21 23:23:23 +00:00
composables consolidate docs into documentation/ and deployment shells into deployment/ 2026-09-21 23:23:23 +00:00
utils consolidate docs into documentation/ and deployment shells into deployment/ 2026-09-21 23:23:23 +00:00
README.md consolidate docs into documentation/ and deployment shells into deployment/ 2026-09-21 23:23:23 +00:00

src/ — this map's sandbox

Everything this map needs that isn't already in the shared library/ gets built here. Nothing in this folder leaks to another map — build freely.

src/
├── api/          which API/CSV/endpoint this map reads
├── colors/       this map's colors: values (colors.json) + strategy .js files
├── components/   this map's own .vue pieces (not reusable)
├── composables/  this map's own logic hooks (useThing.js)
└── utils/        this map's own pure helpers

Two import styles, two meanings:

import { useMapInstance } from '@map/composables/useMapInstance.js'  // reuse the shared library
import colors             from './src/colors/colors.json'            // your own sandbox (relative)

There is no @map/-style alias for your sandbox — your code is always relative. That boundary keeps it private. Reusable + parameterized → library/ (an expert move); specific to this map → stays here. Local by default.

Each subfolder has its own README. See also: ../../README.md (authoring guide) · ../../../documentation/reference.md (the @map/… menu).