APP STORE SCREENSHOTS + LOCAL UX — SESSION HANDOVER Saved 2026-11-10. Workspace: /home/yaya/Projects/archy Branch main, HEAD 92f78072. Changes are UNCOMMITTED; nothing pushed or deployed remotely. START HERE The requested local UX update is complete. User requested this handover for a new session. Recheck live state before further edits; do not redo the collection or restore the withdrawn first batch wholesale. Preserve the good original captures. Local frontend: http://127.0.0.1:8100/ Mock backend: http://127.0.0.1:5959/ Backend user service: archy-ux-backend.service (active, restarted for real LND UI). USER REQUIREMENTS / CORRECTIONS THAT MUST SURVIVE - Collect up to THREE distinct, attractive main/key screens per app; list gaps. - ONLY native DARK MODE, full DESKTOP screenshots. No light views, crops, promotional composites, device mockups, loading states or intro animations. - NO sensitive data: private files, credentials, wallet balances, miner identities, node/peer network addresses. Prefer public demos or isolated demo fixtures. - Official source images are useful too, with source/provenance recorded. - Serve screenshots through app-catalog/server data, independent of UI bundles. - One horizontally scrolling row on desktop and mobile. Images retain natural proportions; the surrounding detail-page glass card MUST remain. - Use the EXISTING Cloud Files MediaLightbox, controls and styling. No bespoke viewer. - Screenshot viewer: no oversized box around the image; rounded actual image; Close X at TOP RIGHT, NO Back button. Arrows must not bounce or dismiss viewer. - Preserve original good Bitcoin Core/Knots and IndeeHub images. User specifically objected when these disappeared during the overly broad first withdrawal. - LND is OUR OWN UI. User explicitly required local UX to serve that real UI, not the substitute placeholder. This has now been fixed and captured. - User prefers plain text file paths/URLs, not Markdown hyperlinks in Herdr. - Do not ask redundant permissions or delegate to agents without explicit authority. DELIVERED CONTENT 39 approved screenshots across 15 apps; 11 complete three-screen sets. Three each: Jellyfin, Nginx Proxy Manager, Immich, Home Assistant, PhotoPrism, BotFights, IndeeHub (id indeedhub), File Browser, Mempool, Grafana, LND. Partial: Bitcoin Core 2, Bitcoin Knots 2, Gitea 1, DATUM 1. 45 catalogue apps surveyed; the full per-app gaps report explains all omissions. Delivery folder: /home/yaya/Pictures/archy-app-store-dark-desktop-2026-11-10/ gallery.html Open locally to review the selected originals. sources.json Approved originals, provenance, review notes and asset hashes. GAPS.txt Every incomplete app and the reason. coverage.csv Machine-readable counts and missing screens. README.txt official/, demo/, live/ Approved originals only. Bundle: /home/yaya/Pictures/archy-app-store-dark-desktop-2026-11-10.zip Selection details: - Bitcoin Core/Knots: restored ORIGINAL node overview + blockchain insights. These show aggregate statistics and generic localhost endpoints, no secrets. Original peer-list screenshots excluded because they expose network addresses. - IndeeHub: original three clean anonymous film-catalogue/details/library views. - BotFights: original anonymous arcade/fight-card/feed views. - DATUM: original thread-statistics view only; status/client views reveal miners. - LND: real docker/lnd-ui with demo fixtures; Overview, Channels, Activity. No real wallet credentials/balances. Sample alias is archipelago-demo. - File Browser: actual v2.63.23 upstream binary with isolated sample documents and public landscape photos. Its public demo DNS was broken. Temporary loopback capture server on 12860 was STOPPED after capture; not a permanent UX service. - Grafana: fresh public Grafana Play dashboards; waited for loaded charts, scrolled to useful chart panels within full 1440x900 desktop viewport. No screenshot crops. - Immich/PhotoPrism/Home Assistant: official public demo fixtures in native dark UI. - Mempool: public blockchain explorer screens, not user wallet data. - Gitea: anonymous upstream public repository, one clean view; further routes redirected to sign-in. Source repository was archived; provenance notes this. - Jellyfin/NPM: upstream full dark desktop references; source version/commit kept. - 51 Umbrel gallery candidates examined, rejected as composites/light-mode content. WITHDRAWN FIRST BATCH — DO NOT PUBLISH /home/yaya/Pictures/archy-app-store-2026-11-10/ /home/yaya/Pictures/archy-app-store-2026-11-10-WITHDRAWN.zip These contain mixed light/cropped/private captures and are NOT the current delivery. READ-FIRST-WITHDRAWN.txt explains. Old served assets were moved out of the repository into withdrawn-store-assets. Only individually re-reviewed clean images were copied into the current delivery. Private SSH/browser credential directories were deleted and SSH masters closed. Do not put SSH passwords into handover files or repository. Rejected/new superseded originals are outside delivery under: /home/yaya/.cache/archy-store-dark/rejected-originals/ CODE CHANGES (ALL STILL UNCOMMITTED) 1. app-catalog/catalog.json and neode-ui/public/catalog.json Ordered screenshot objects {src,alt}; 39 selected references. 2. app-catalog/screenshots//-.webp (NEW, untracked) Canonical optimized image bytes, max dimension 1920, original aspect preserved. app-catalog/screenshot-sources.json (NEW) records provenance/review/hash. app-catalog/README.md documents architecture and current quality/privacy rules. 3. scripts/generate-app-catalog.sh Copies screenshot lists into manifest.app.metadata.screenshots, including manifest_variants. Removes stale screenshot metadata when a catalogue entry has no screenshots. Generates into temporary preview for verification only. DID NOT overwrite/sign releases/app-catalog.json. 4. neode-ui/mock-backend.js GET /api/app-catalog reads canonical catalogue plus baseline release manifests, returns keyed {apps:{id:{...,manifest:{app:{metadata:{screenshots}}}}}} shape. Mock is intentionally unsigned; production daemon retains signature verification. Rewrites registry screenshot URLs to /api/app-catalog/screenshots/... and serves canonical bytes via express.static, immutable cache, 1 year. Also now serves actual LND directory at /app/lnd and /app/lnd-ui, removes old LND placeholder from DEMO_APP_PAGES, supplies missing demo REST endpoints. 5. neode-ui/src/views/discover/curatedApps.ts Carries screenshots from signed manifest metadata. Community fallback decorates only existing title/description/icon; it does not override signed screenshots. 6. neode-ui/src/components/AppScreenshotGallery.vue (NEW, untracked) Shared natural-aspect horizontal strip. Uses existing MediaLightbox with frameless prop. Preserves thumbnail focus for accessible close/keyboard behavior. 7. neode-ui/src/views/MarketplaceAppDetails.vue Shared gallery inside preserved glass card; min-w-0 for proper overflow. FIXED REAL DIRECT-LINK/RELOAD BUG: previously relied only on in-memory selection and redirected to marketplace when absent. Now fetches app from verified catalogue on mount when selection missing; disposal guard prevents stale update. 8. neode-ui/src/views/appDetails/AppContentSection.vue Same gallery for installed apps; obtains catalogue screenshots with request counter/unmount guard to prevent stale app data being applied. 9. neode-ui/src/components/cloud/MediaLightbox.vue Optional frameless mode used only for app screenshots; regular Cloud viewer retains its panel. Frameless has transparent panel, zero padding/border/shadow, actual image radius, fixed top-right actions and Close X, no Back control. Fixed nav positioning and disabled global active-button scale with necessary specificity. Restricts transitions to colors/borders rather than transform/all. This fixes arrow bounce and mouse-up landing on backdrop/dismissing viewer. data-controller-keyboard="native" prevents competing page-controller navigation. 10. neode-ui/src/composables/useControllerNav.ts Modal visibility uses getClientRects + visibility (offsetParent fails on fixed elements). Native keyboard modal bypass fixes Escape navigating page back and arrow-key focus stealing from MediaLightbox. 11. docker/lnd-ui/index.html Manage Channels link retains window.location.origin (including UX port) when hosted under /app/. Standalone app still targets dashboard on standard web port. LND DEMO IMPLEMENTATION Local actual UI: http://127.0.0.1:8100/app/lnd/ Uses existing static UI assets with /app//assets -> /assets redirect. Mock REST: readiness, getinfo, channels, pending channels, peers, fees, graph info, payments, invoices, transactions, on-chain/channel balances. Fixtures reused from MOCK_LND_DATA where possible. Four active channels sum to 8,250,000 local and 11,750,000 remote sats, matching balance endpoints. Demo peer IPs use documentation range 192.0.2.x. Node/peer keys are stable synthetic values. No real node queried. Manage Channels target: http://127.0.0.1:8100/dashboard/apps/lnd/channels PUBLICATION STATE / IMPORTANT LIMITATION Local UX update is live. No remote deployment, commit, push or release signing. Canonical source URLs currently point to intended registry location: https://source.archipelago-foundation.org/lfg2025/archy/raw/branch/main/app-catalog/screenshots/... Those NEW files are NOT published there yet. Local backend rewrites them to its working image endpoint. Publish assets BEFORE publishing a signed catalogue that references them. Do not casually replace live signed release data with mock data. Other agent owns shared-platform remote integration/deployment. Before touching DATUM/Gashboard/platform read: /home/yaya/Projects/archy-mining-reviews/SESSION-CONTEXT.txt VERIFICATION COMPLETED - 95 existing tests across six files passed: curatedApps.portAuth, CopyPublicWriters, useMarketplaceApp, AppContentSection, MediaLightboxMobile, useControllerNav. - vue-tsc -b passed after direct-link fix. Run through Node directly; npm pretest encountered local mise/corepack setup issues earlier (not a product failure). - node --check neode-ui/mock-backend.js and git diff --check passed after LND change. - Final 39 screenshot URLs all return image responses HTTP 200 through port 8100. - Generated release preview preserves all 39 screenshot references in base and variant manifests and removes absent galleries. Preview only, no signing. - Chromium desktop + phone: 73 checks EACH for Jellyfin, Grafana and File Browser: direct links, decode, proportions, single horizontal row, no document overflow, existing Cloud lightbox, no surrounding box, rounded image, top-right Close, stationary pressed arrows, repeated pagination, keyboard previous/Escape/focus. - Firefox + WebKit desktop/phone: 27 checks EACH on File Browser/shared viewer. - LND actual UI Chromium desktop/phone: 9 checks EACH; real six-tab UI, sample alias, correct channel link, four tabs open, every polled demo REST endpoint succeeds. - Mobile is viewport emulation, not physical-device certification. Correct browser reports (some earlier reports are stale failures): /home/yaya/.cache/archy-store-dark/ux-route-fix/chromium-desktop/result.json /home/yaya/.cache/archy-store-dark/ux-phone-final/chromium-phone/result.json /home/yaya/.cache/archy-store-dark/ux-cross-final/{firefox,webkit}-{desktop,phone}/result.json /home/yaya/.cache/archy-store-dark/lnd-real/chromium-{desktop,phone}/result.json /home/yaya/.cache/archy-store-dark/asset-audit.json /home/yaya/.cache/archy-store-dark/release-final-preview.json Earlier test runs failed from missing direct-link support (fixed), or browser process termination/memory pressure. Later reports above passed; do not cite an earlier interrupted phone run as the final result. Heavy Rust compilation in archy-indeehub-payments belongs to another agent; NEVER stop their processes. REUSABLE LOCAL TOOLING (NOT IN REPOSITORY) Skill: /home/yaya/.codex/skills/browser-check/SKILL.md Runner: /home/yaya/.local/bin/browser-check Scenarios: /home/yaya/.local/share/browser-check/projects/archy-store/ store-installed.mjs full 3-app gallery/direct-link checks store-cross.mjs focused File Browser shared lightbox checks lnd-real.mjs real LND UI + capture (creates 4 candidates, only 3 selected) other scripts are capture/exploration helpers; read before rerunning. Typical command: TMPDIR=/home/yaya/.cache/archy-store-dark BROWSER_CHECK_CHROMIUM_PATH=/opt/brave-bin/brave ~/.local/bin/browser-check --base=http://127.0.0.1:8100/ --scenario=/home/yaya/.local/share/browser-check/projects/archy-store/store-installed.mjs --out=/home/yaya/.cache/archy-store-dark/NEW-REPORT --engines=chromium --profiles=desktop,phone --timeout=300000 Default shared Chromium hung; Brave executable works. Firefox/WebKit available. Use TMPDIR above, not /tmp (quota). Run browsers sequentially if memory tight. /home/yaya/.cache/archy-store-dark/install-approved.py Rebuilds WebP assets and BOTH catalogues from approved delivery sources.json. Enforces original dimensions >=1200x600. Do not run until new images reviewed. /home/yaya/.cache/archy-store-dark/finish-report.py Rebuilds gallery/gaps/CSV/ZIP from approved files. Moves unselected originals OUT of delivery folder into rejected-originals. Update reason strings for new discoveries. No unapproved files should enter the ZIP. ImageMagick available; Pillow not installed. Use view_image to review captures. REMAINING WORK IF USER WANTS TO CONTINUE - Full list in delivery GAPS.txt. Only 11/45 apps have complete three-screen sets. - Core/Knots need a clean third distinct screen, not original peer IP lists. - Gitea and DATUM each have one; many other apps need isolated populated demos. - Prioritize real existing Archipelago demo UIs (as with LND) over promo images. - Preserve clean originals; do not repeat blanket removal. Keep the privacy rule. - If publishing later, review diff/provenance and coordinate remote ownership; commit approved assets/UI changes and generate/sign/release catalog properly. PRE-EXISTING UNTRACKED FILES — DO NOT TOUCH OR CLAIM Android/app/debug.keystore NOTES-angor-frpc-handoff.md core/archipelago/src/appgate/testdata/._leaf.key core/archipelago/src/appgate/testdata/._other.key docs/1.8-alpha-improvements-tracker.md docs/HANDOFF-2026-10-10-RASPBERRY-PI-ARM64.md docs/SESSION-1.8.0-OTA-PROGRESS.md docs/apple-silicon-m2-development-research.md image-recipe/branding/source-backgrounds/ image-recipe/branding/source-logos/ FOLLOW-UP — ELECTRUMX, NEXTCLOUD, GASHBOARD (2026-11-10) User requested these three additional apps. Counts above are now superseded: 47 approved screenshots across 18 apps; 13 complete three-screen sets. Added ElectrumX 2 (synced/local connection, Tor connection), Nextcloud 3 (Files, Photos, Documents), Gashboard 3 (dashboard, miner performance, telemetry). All full 1440x900 native-dark desktop screenshots, visually reviewed. Existing 39 assets remain untouched and their recorded SHA256 hashes still verify. Updated both local catalogues, screenshot-sources.json, delivery sources.json, gallery, gaps/coverage, README and ZIP. No remote publication or signing. ElectrumX is already the real docker/electrs-ui shell. Fixed its mock endpoint status from ready to synced to match the shell contract; replaced random fake onion with explicitly fictional example-demo-only.onion. Screenshot fixture uses only loopback and fictional onion. Local backend restarted with this fix. Nextcloud used an isolated nextcloud:29-apache container (29.0.16.1, matching catalogue major version), SQLite, sample user, bundled upstream sample files, and native dark theme. No personal storage mounted. Container archy-store-nextcloud-capture is STOPPED, retained locally for reproducibility. It served only loopback port12861. Use /apps/photos/photos (without /index.php) for correct frontend routing. Earlier empty Photos/404 captures are rejected. Gashboard used an unmodified copy of current docker/gashboard/apps/web under /home/yaya/.cache/archy-store-dark/gashboard-app, dependencies from existing archy-gashboard-sparse checkout. Only copied tsconfig extends path adjusted. API intercepted in capture browser with fictional demo miners and generated one-hour telemetry; polling accelerated in browser fixture to populate ticker. No live mining backend queried. Capture service archy-store-gashboard-capture on loopback12862 is STOPPED. Does not change shared-platform deployment. Capture scripts in /home/yaya/.local/share/browser-check/projects/archy-store/: electrumx-real.mjs, nextcloud-capture.mjs, gashboard-capture.mjs. Approved reports under /home/yaya/.cache/archy-store-dark/: electrumx-approved, nextcloud-approved2, gashboard-approved3. Each passed Chromium desktop capture checks; manual visual review excluded blank, error and incomplete candidate images from earlier report directories. Local add-three-apps.py installed just these eight assets, preserving originals; finish-report.py regenerated the delivery. All47 local image URLs return200 and all47 stored image hashes verify. node --check and git diff --check passed. Local UX remains running at http://127.0.0.1:8100/ with backend5959. User services: archy-ux-frontend (transient), archy-ux-backend. Final gallery verification: three-galleries.mjs passed Chromium153 desktop and phone,18 checks each: all three app direct routes,2/3/3 gallery counts,1440x900 image decode, no document overflow, existing Cloud lightbox and pagination. Report: /home/yaya/.cache/archy-store-dark/three-galleries-final. SIDEBAR CONNECTION STATUS FOLLOW-UP (2026-11-10) User requested Online and Relay side by side, Online LEFT, Relay RIGHT, with centered inner content; requested Relay visible on local dev server as well. DashboardSidebar.vue groups both cards in a flex row; CompanionIndicator.vue keeps labels within available width and centers its activity dot with content. Mock backend now routes /ws/db and /ws/remote-relay upgrades explicitly to separate WebSocket servers. Demo relay stays idle with ping heartbeat; no invented input or forwarding between visitors. Existing /ws/db initial data verified through8100. Backend restarted. Local frontend has changes through HMR; no remote deployment. Browser scenario: /home/yaya/.local/share/browser-check/projects/archy-store/sidebar-status.mjs Final report: /home/yaya/.cache/archy-store-dark/sidebar-status-centered Checks cover actual dev relay connection, left/right order, centered content, Relay/Companion labels at1440/1024 widths, card fit, and Online opening CLI. FINAL CLOUD UX AND RELEASE HANDOFF (2026-11-10) These final requirements supersede earlier viewer/layout notes above. Branch: ux-and-screenshots. Intended for a later release; no production deployment. All shared lightbox callers are frameless, including Nextcloud documents, Cloud, peer files and app screenshots. The old framed Back-button layout is removed. Image swipes navigate horizontally; vertical drags and pinch gestures do not. Mobile image arrows are raised, with 24px edge insets; menu/fullscreen/close are centered at the bottom. Video uses the prior frameless layout and dedicated safe-area controls, with native playback/seeking/fullscreen/PiP logic retained. Cloud remembers each folder's page/list scroll position while navigating within Cloud. Returning restores it after loading; leaving Cloud clears the visit. Home retains Storage Used on the LEFT and replaces folder counts on the RIGHT with the last three distinct files opened/downloaded/received. Containers and 56px square previews match My Apps. Documents use existing file-type SVG icons. History lasts for the browser tab session, survives reload, and clears on logout. Only file descriptors are persisted; temporary media URLs are not persisted. Final catalogue: 47 approved screenshots across 18 apps, 13 complete sets. ElectrumX adds two; Nextcloud and Gashboard add three each to the original 39. Canonical WebP assets and provenance are in app-catalog/. Catalog generation preserves the gallery metadata. Release agents must regenerate/sign the release catalogue through the usual release process; signed release files were not edited. Verification artifacts remain LOCAL outside the repository under /home/yaya/.cache/archy-store-dark/. Sidebar passed Chromium/Firefox/WebKit. Cloud image/document checks passed Chromium/WebKit; Firefox automation timed out. Video playback, pause/seek, fullscreen enter/exit and close cleanup passed Chromium/WebKit desktop and phone viewport checks. PiP is covered by existing unit regressions; real-device Safari/PiP behavior is not claimed from emulation. Scroll traversal/return/reset passed Chromium. Home recent-file checks exercise ordering, previews, storage/container preservation, reopening and reload. Use the global browser-check suite; do not commit local browser fixtures/reports. Local review: http://127.0.0.1:8100/ (demo backend on 5959). No shared mining/platform deployment was performed; that remains other-agent work.