archy/docs/device-models.md

Interactive hardware illustrations

The radio detection modal and unconfigured OpenWrt gateway use original procedural Three.js models. The renderer follows the studio lighting, rounded geometry, material finishes and instancing approach used for the computer illustrations in archipelago-website-deck.

Coverage

neode-ui/src/graphics/deviceModels.ts contains 25 radio illustrations, including the generic fallback and three optional enclosure variants, plus the Beryl AX (GL-MT3000) and a black Pixel 9 Pro. All existing meshDeviceImages.ts detection results resolve to a procedural model key. USB chip identification remains a best-effort visual match; it does not select firmware or claim exact hardware.

The radios include modeled rear faces, enclosure panels or populated boards, and appropriate battery holders, connectors and antennas. These are stylized recognition illustrations, not CAD models. Fine component placement and rear details are representative; not every board revision or enclosure has been verified against a rear photograph. The Beryl AX is the example router from docs/openwrt-gateway-setup.md, not an assertion about the connected router.

Reference material:

• Beryl AX official front/rear/side hardware drawing: https://static.gl-inet.com/docs/router/en/4/user_guide/gl-mt3000/hardware_info/mt3000_interface.jpg
• Beryl AX guide: https://docs.gl-inet.com/router/en/4/user_guide/gl-mt3000/
• T-Echo manufacturer board and enclosure reference: https://github.com/Xinyuan-LilyGO/T-Echo https://raw.githubusercontent.com/Xinyuan-LilyGO/T-Echo/main/image/T-ECHO.jpg
• T-Deck manufacturer documentation: https://wiki.lilygo.cc/products/t-deck-series/t-deck/

Manufacturer photographs are references only; none are copied into the app. Geometry, grain and device labels are generated locally without CDN assets. The black Pixel 9 Pro illustration uses an unmodified, locally bundled GrapheneOS boot logo mask from its framework source. Its rounded outline, glass panels, camera island, layered lenses, side buttons and ports are procedural geometry. The display shows a static phase of the OS boot animation, distinct from Google's bootloader notice. Source and attribution: neode-ui/src/graphics/assets/ATTRIBUTION.md.

Interaction and lifecycle

DeviceModel.vue loads the renderer on intersection. It turns once per minute, capped at 30 rendered frames per second. Drag horizontally to rotate; a mouse can also tilt vertically. Touch preserves vertical page scrolling. Arrow keys rotate/tilt, Home shows the front and End shows the back. Keyboard interaction pauses automatic turning. The Pause/Rotate button controls autoplay.

Reduced motion disables autoplay and hides its control while preserving manual rotation. Hidden tabs and offscreen models stop scheduling frames. Model changes reuse the renderer/environment and dispose the previous geometry, textures and materials. Unmount releases the renderer and context. Unsupported browser APIs, unavailable WebGL, import failures or lost contexts leave a static fallback.

The router figure uses the remaining viewport height below the connection form on desktop (minimum 260px); mobile layouts get a fixed 290px illustration. Small desktop windows can scroll normally rather than collapsing the model to zero height.

Hardware discovery

The router gateway and private-phone Setup goal share HardwareMarketplace.vue. Buy router / Buy phone replaces the model with a horizontal product carousel, preserving the outer container's height. Discovery queries enabled relays from nostr.list-relays for NIP-99 kind-30402 events. Phone discovery uses the pixel keyword. Development builds show clearly labeled sample listings when no matching live listings are found. Production never substitutes these samples. Offers must pass bounded kind-30402 event/hash/ Schnorr-signature validation. Inventory follows addressable-event replacement (timestamp, then lowest event ID), including sold/inactive, expired and nonmatching replacements so old active offers do not reappear within a search. Signed kind-5 event/address deletion requests are applied only to the signing author's own offers; a later addressable version can follow an earlier address deletion. The bounded relay snapshot cannot establish complete relay history.

View opens source details, seller public key, event ID and a NIP-19 addressable nostr: link for an installed Nostr app. Signed claims are explicitly not seller identity, availability or hardware-support endorsements. Checkout/Buy remains disabled: discovery does not authorize purchases. Refresh failures clear stale inventory; category switches and closing cancel old work. The details use the shared focus-trapping modal with Escape/focus restoration.

Local synthetic signed-event regression and actual production-component browser fixtures are maintained at tests/apps/hardware-discovery/. Their receipts do not establish live-relay, external-handler, installed-node or physical acceptance.

Historical 3D-device browser scenarios and reports remain outside this repository, under /home/yaya/.local/share/browser-check/projects/archy-devices/.

Validation (2026-10-09)

• Production typecheck/build passes; the lazy renderer chunk is 136 KB gzipped.
• Existing gateway/cache tests (10) and radio setup tests (2) pass.
• Chromium 153, Firefox 155 and WebKit 26.6 pass at desktop 1440×900 and phone 390×844: all 26 models, front/back rotation, drag, autoplay/pause, reduced motion, zero offscreen/idle draws, model replacement, unmount/remount and context-loss fallback. Reports: /tmp/archy-models-final/.
• Actual gateway and detection-modal components pass the same six-case matrix with mocked RPC data. Reports: /tmp/archy-device-pages-matrix/.
• Delayed renderer loading, storage denial, reload and unavailable WebGL pass the same matrix. Reports: /tmp/archy-device-fallbacks/.
• These are Linux browser tests with phone viewport emulation, not physical iPhone/Android GPU or touch-scroll certification. No live router was changed.

Branch: feat/3d-mesh-router, based on ngit main 5812f53c7c05027848a1007f818e9d33117b62e0. The ngit helper could read relay state but failed Git server authentication; main's published kind-30618 ref was checked on relay.ngit.dev and that exact commit fetched from the existing Git mirror. No remote proposal, merge or deployment was performed.