Files
archy/docs/HANDOFF-2026-11-10-APP-STORE-SCREENSHOTS.txt

326 lines
21 KiB
Plaintext

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/<app-id>/<stem>-<sha12>.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/<id>/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.