doxa-life/doxa-maps-cdn
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Docs and comments: neutral wording, no private hosts or tool folders

Browse source 
- The laptop guide clones from <repository-url> instead of a private host, and states what the
  Deep Research page is now (a full-page app with a "Back to homepage" button) and the link text
  under the research map ("Deep Research app").
- The two-route laptop guide speaks of a shared server instead of a team's, and no longer names
  where an outside checker lives.
- The 1040-maps .gitignore drops a line for a local tool folder; the SemanticTreeLegend header
  describes the clone in plain terms.

No behaviour changes.
This commit is contained in:
Doxa Life 2026-10-01 00:06:16 +00:00
parent fd771272f7
commit 6bad2cb3f5
4 changed files with 15 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
MOBILIZATION-MAPS-LAPTOP.md
View file

@ -6,12 +6,12 @@ hidden Deep Research page and the Research page. No database, no Docker, no secr
## You need
- **bun 1.3+** and **node 20+**
- Your login for git.nuxtbase.app (the repo is private)
- **git**, and the address of the repository that holds this branch
## Steps
```bash
git clone -b deep-research --single-branch https://git.nuxtbase.app/doxa-life/doxa-maps-cdn.git dx-life-deep-research
git clone -b deep-research --single-branch <repository-url> dx-life-deep-research
cd dx-life-deep-research
bun install
PORT=4611 bun run dev
@ -55,11 +55,12 @@ back to MapLibre, so a map always starts.
## What is in this branch
- `/deep-research`: the Deep Research gallery (the DX Maps mobilization maps in one app, the
Experimental section included), filling the page below the header. Every tab has an info button
Experimental section included), as a full-page app with no site header; its "Back to homepage" button sits
above the menu's Collapse button. Every tab has an info button
that explains what the map does.
- `/research`: DX Life's production page (fc4d622), with the research map on its own, now loaded from
this site's own `/dx-maps/`, and under it one new line: "Want Deeper Research? See our
Deep-Research Maps →", which links to `/deep-research` in the reader's language. The line is in all
this site's own `/dx-maps/`, and under it one new line: "Want Deeper Research? Deep Research
app →", which links to `/deep-research` in the reader's language. The line is in all
11 of the site's locales.
- `/` and `/pray`: the engagement map and the prayer map (the simple map with those presets), as before.
- `public/dx-maps/`: the DX Maps output folder, from DX Maps `development` 32715a5cc.

16
documentation/LAPTOP-6WAY.md
View file

@ -1,13 +1,13 @@
# The Research Gallery on your laptop: two routes
DX-life takes the dx-maps Research Gallery in **two routes**, one branch each. This page runs each of them on a
laptop, so you can see and test them before any server is involved. The same two run on the team's servers;
laptop, so you can see and test them before any server is involved. The same two run on a shared server;
together that is the embed test (2 routes × laptop and server).
| Route | DX-life branch | What runs | Docker | PocketBase |
|---|---|---|---|---|
| **Drop-in** (the default) | `research-gallery-drop-in` | this site alone; the maps are its own copy in `public/dx-maps` | no | no |
| **Subdomain** | `research-gallery-subdomain` | the dx-maps **team container** (Plugin Studio, PocketBase, the research site) + a local sign-in + this site | yes, about 5 GB | yes, for plugins that have users, an API or a database |
| **Subdomain** | `research-gallery-subdomain` | the dx-maps **container** (Plugin Studio, PocketBase, the research site) + a local sign-in + this site | yes, about 5 GB | yes, for plugins that have users, an API or a database |
The **CDN** route (`research-gallery-cdn`) was retired on 2026-09-29. Its branch is kept for history.
@ -15,7 +15,7 @@ The **CDN** route (`research-gallery-cdn`) was retired on 2026-09-29. Its branch
- **Checkouts side by side:**
```
doxa-maps/ dx-maps, on development (the team's table) or main (production)
doxa-maps/ dx-maps, on development (work in progress) or main (production)
doxa-life/ this repo
```
- **bun 1.3+** and **node 20+**. For the subdomain route, **Docker** with Compose: it uses about 1.4 GB, 2.5 GB while
@ -44,7 +44,7 @@ git restore public # dx-maps b
Afterwards, put the site's copy back: `git restore public/dx-maps && git clean -fdq public/dx-maps`.
## 2. Subdomain (the dx-maps team container, with PocketBase)
## 2. Subdomain (the dx-maps container, with PocketBase)
```bash
cd doxa-life && git switch research-gallery-subdomain
@ -52,8 +52,8 @@ bun run laptop subdomain
```
**The first time,** it makes `.env.laptop` (secrets, never committed) and stops if `GIT_TOKEN` is empty.
- Put a read token for the team's git server there and run it again.
- It builds dx-maps' container from `../doxa-maps/Dockerfile`, the image the team's server runs.
- Put a read token for the git server that hosts the repositories there and run it again.
- It builds dx-maps' container from `../doxa-maps/Dockerfile`, the image the shared server runs.
- Pull dx-maps `development` first. The first start takes 5-10 minutes: the container clones, installs and
publishes.
@ -66,7 +66,7 @@ It starts three services, all on `127.0.0.1` only:
| http://localhost:4616/ | the Plugin Studio, PocketBase (`/pb`), `/cdn`, `/admin` |
| http://localhost:4620/team | the local sign-in provider |
**Sign-in and roles**, the same as the team's server:
**Sign-in and roles**, the same as on the shared server:
- Sign in to the Studio as **`admin`** (everything, including publishing and the PocketBase dashboard) or
**`designer`** (the Studio and PocketBase's API).
- Any other name is a plain team member, and is refused, as on the server.
@ -92,7 +92,7 @@ deletes them. `bun run laptop status` shows what's running.
`/ar/embed-test` runs the same test right to left.
- **`/research/?tab=regions-dashboard`** opens the gallery on its Regions tab, and `/regions` redirects there.
On the subdomain route that means `http://research.localhost:4615/?tab=regions-dashboard`.
- **Headless**, dx-base's `check-embed-6way.mjs` (in the fleet's QA folder) checks, for every production plugin:
- **Headless**, a checker kept outside this repository (`check-embed-6way.mjs`) checks, for every production plugin:
the script, its integrity hash, its element, its page, CORS, and the copy-paste snippet. The label reads
`<name>=<site origin>@<manifest URL>`:
- drop-in: `drop-in=http://localhost:4611@http://localhost:4611/dx-maps/manifest.json`;

1
embeddables/micro-frontends/1040-maps/.gitignore vendored
View file

@ -26,7 +26,6 @@ dist/
# Internal engineering scratch — never commit
.local-scratch/
.lk10x/
.agent-restricted
build-status.md
embeddables/**/intel/

3
embeddables/micro-frontends/1040-maps/src/components/SemanticTreeLegend.vue
View file

@ -2,8 +2,7 @@
/**
* SemanticTreeLegend — reusable hierarchical legend for any one-to-many semantic tree.
*
* EXACT CLONE of the upstream PPLR module
* per user directive: "do a direct clone, only shave the API." Only difference vs.
* EXACT CLONE of the upstream PPLR module: a direct clone in which only the API is reduced. Only difference vs.
* upstream is the <style scoped> block converted to useShadowStyles() so the CSS
* lands inside doxa-research-mfe's shadow root.
*