From e6ac6407c97cabe8d3b8df730ffe2e6362f295d6 Mon Sep 17 00:00:00 2001 From: doxa-maps-88655c70 <88627970+doxa-maps-88655c70@users.noreply.github.com> Date: Sun, 20 Sep 2026 05:00:01 +0000 Subject: [PATCH] README: distinguish the two cap-5 apps (product SPA vs developer studio) and add current capability screenshots --- README.md | 131 +++++++++++++++++- docs/screenshots/cap-1-single-element.png | Bin 0 -> 703412 bytes docs/screenshots/cap-2-prop-table.png | Bin 0 -> 876112 bytes docs/screenshots/cap-3-monolithic.png | Bin 0 -> 624841 bytes docs/screenshots/cap-4-nested-element-spa.png | Bin 0 -> 539453 bytes docs/screenshots/cap-5-nested-spa.png | Bin 0 -> 522301 bytes docs/screenshots/map-cities-internet.png | Bin 0 -> 262862 bytes docs/screenshots/map-gospel-resources.png | Bin 0 -> 267880 bytes 8 files changed, 126 insertions(+), 5 deletions(-) create mode 100644 docs/screenshots/cap-1-single-element.png create mode 100644 docs/screenshots/cap-2-prop-table.png create mode 100644 docs/screenshots/cap-3-monolithic.png create mode 100644 docs/screenshots/cap-4-nested-element-spa.png create mode 100644 docs/screenshots/cap-5-nested-spa.png create mode 100644 docs/screenshots/map-cities-internet.png create mode 100644 docs/screenshots/map-gospel-resources.png diff --git a/README.md b/README.md index 6e17edee7..2f0ab01d1 100644 --- a/README.md +++ b/README.md @@ -27,8 +27,8 @@ This README is a **show, don't tell** index. Skim the three tables, then jump to | 1 | **iframe embed** on any site | required | [§2](#deploy-1--iframe-embed) | | 2 | **Mobile app** (Android / Capacitor) | required | [§2](#deploy-2--mobile-app) | | 3 | **Direct-JS / research dashboard** (props + events + SRI) | required | [§2](#deploy-3--research-dashboard-direct-js) | -| 4 | **WordPress** (same artifacts, Custom HTML block) | deferred POC | [§3](#3-cli-commands--installs-per-deploy-method) | -| 5 | **Desktop** (Tauri) | deferred POC | [§3](#3-cli-commands--installs-per-deploy-method) | +| 4 | **WordPress** (PHP plugin: shortcode + Gutenberg block) | built, not yet shot | [§3](#3-cli-commands--installs-per-deploy-method) | +| 5 | **Desktop** (Tauri) | aspirational (no code yet) | [§3](#3-cli-commands--installs-per-deploy-method) | ### CLI commands + what to install @@ -96,7 +96,32 @@ the UPG-100 list plugin. The composite (`upg-100-mfe`) plus its list pages: build. A vertical-tab sidebar groups every plugin by capability (CAP 5 → 1); clicking a row mounts that plugin. This same SPA is the Capacitor mobile-app entry (see deploy 2). -![Capability 5 — the doxa-maps SPA (all plugins, one app)](docs/readme-images/cap5-doxa-maps-spa.png) +**`plugin-studio` is itself a CAP-5 plugin, AUTO-GENERATED by the Vite build step.** You do not hand-write +it — the build discovers every folder in `plugin-designs/`, bundles each, and generates the studio SPA that +composes them (a `nested-spa-single-spa` / app-shell tier plugin). Add a plugin-design folder, run the +build, and it appears in the studio automatically. (`doxa-maps-spa` is the curated product SPA; `plugin-studio` +is the auto-generated gallery of everything built — same cap-5 tier, both built by `bun run build`.) + +**Two shared layouts back the cap-5 tier** (in `library/layouts/`, brand-neutral + reusable by any plugin): +- **`VerticalTabsLayout`** — one element visible at a time (the sidebar-tab shell above). Lazy-mounts each + tab's element on first open. +- **`StackLayout`** — the *opposite*: all elements STACKED top-to-bottom at natural height, so the host page + scrolls through them (the doxa-life / nuxtinator page-flow model). Group two elements and embed the pair. + +**The two cap-5 apps, side by side.** They are different products at the same tier and the distinction +matters when you embed one: `doxa-maps-spa` is what an END USER gets, `plugin-studio` is what a DEVELOPER +reviews. (Captioning a studio shot as the product SPA is a documented mistake — see `/plugin-designer`.) + +*`doxa-maps-spa` — the curated PRODUCT SPA.* Vertical tabs grouped by audience, not by capability: +Prayer Mobilization (Big Picture · UPG-100 List · Prayer Progress · Gospel Resources) → Research +(Cities & Internet · Research Map) → Experimental. Tab 1 is the cap-4 Big Picture composite. + +![Capability 5 — doxa-maps-spa, the curated product SPA](docs/screenshots/cap-5-nested-spa.png) + +*`plugin-studio` — the AUTO-GENERATED developer gallery.* The same cap-5 tier, but the sidebar groups every +built plugin by capability (CAP 5 → 1) so an author can review the whole catalogue after a build. + +![Capability 5 — plugin-studio, the auto-generated developer gallery](docs/readme-images/cap5-doxa-maps-spa.png) --- @@ -144,18 +169,114 @@ Quick reference: | 1 | **iframe embed** | Bun | `bun install` → `bun run build` → `bun run serve` (or drop `public/doxa-maps/` on any host) | | 2 | **Mobile (Android)** | Bun · Android SDK + `adb` · JDK 17 · Capacitor (devDep) | `bun run phone` | | 3 | **Direct-JS / dashboard** | Bun | `bun run build`, then paste the `