326 lines
21 KiB
Plaintext
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.
|