# Replace Intro & Dashboard Backgrounds Dashboard backgrounds can be replaced by filename. The intro uses paired still/video assets and a media revision, as described below. **Location:** All images go in `neode-ui/public/assets/img/` **Format:** JPG recommended. Portrait or landscape; they use `background-size: cover` and `center center`. --- ## Intro Background and Video The cinematic has two alternatives. Each uses a matched first-frame poster and video, selected consistently by node hostname in `src/utils/introMedia.ts`. The development/demo query `?introScene=original` or `?introScene=red-sunset` previews either alternative. Different hostname/IP aliases can select different scenes; the selection does not wait for authenticated node data. | Scene | Poster in `assets/img/` | Playback file in `assets/video/` | |-------|-------------------------|---------------------------------| | Original islands | `bg-intro-original-loop.webp` | `video-intro-original-360.mp4` | | Red sunset | `bg-intro-red-sunset-loop.webp` | `video-intro-red-sunset-360.mp4` | Keep each poster identical to the video's opening/closing composition. Replace both files together and increment the paired media revision in `introMedia.ts` for a release. The canonical `bg-intro.jpg` remains the original high-resolution still and dashboard default; `bg-intro-2.jpg` is the red sunset source artwork. Playback files use H.264 MP4, yuv420p and fast-start metadata. The original revision 3 is derived directly from the new native 3840×2160, 24 fps Higgsfield render using `bg-intro.jpg`. The original source video is retired; do not restore `video-intro.mp4`. The current 4K master preserves the exact generated HEVC bytes. The original desktop copy is 1920×1080 (6,570,846 bytes); its mobile copy is 1280×720 (2,737,320 bytes). Red sunset's mobile copy is 1,772,297 bytes. Mobile files use the suffix `-360-mobile.mp4`. Small viewports and reported slow connections select the smaller file once per page visit. The original loop uses the generated frames without the former endpoint blend, which caused a visible warp back to the canonical still. Its poster comes from its first video frame. Only the chosen playback copy downloads; all intro variants are excluded from service-worker precaching. The complete file is loaded before animation starts, so slow connections keep the matching still without blocking the interface. Reduced-motion, Save-Data and reported 2G connections do not download video. A persistent pair of predecoded elements keeps playback through splash/login transitions and prepares the next loop offscreen; inactive tabs pause playback. The 4K master is for manual preview/export and is never automatically loaded. --- ## Dashboard Tab Backgrounds | Filename | Tab | |----------|-----| | **`bg-home.webp`** | Home | | **`bg-web5.jpg`** | Web5 | | **`bg-network.jpg`** | Server / Network | | **`bg-settings.webp`** | Settings | | **`bg-myapps.webp`** | My Apps | | **`bg-appstore.webp`** | App Store / Marketplace | | **`bg-cloud.webp`** | Cloud | | **`bg-intro.jpg`** | Default (also intro) | | **`bg-intro-3.jpg`** | Alternate layer during transitions | --- ## Intro Flow Backgrounds (onboarding) | Filename | Used for | |----------|----------| | **`bg-intro-1.webp`** | Onboarding done, login | | **`bg-intro-2.jpg`** | Onboarding verify | | **`bg-intro-3.jpg`** | Onboarding path, dashboard transition layer | | **`bg-intro-4.webp`** | Onboarding options | | **`bg-intro-5.webp`** | Onboarding did | | **`bg-intro-6.webp`** | Onboarding backup | --- ## Quick Reference | Asset | Full path | |-------|-----------| | Original intro poster | `neode-ui/public/assets/img/bg-intro-original-loop.webp` | | Original intro video | `neode-ui/public/assets/video/video-intro-original-360.mp4` | | Home | `neode-ui/public/assets/img/bg-home.webp` | | Web5 | `neode-ui/public/assets/img/bg-web5.jpg` | | Network | `neode-ui/public/assets/img/bg-network.jpg` | | Settings | `neode-ui/public/assets/img/bg-settings.webp` | | My Apps | `neode-ui/public/assets/img/bg-myapps.webp` | | App Store | `neode-ui/public/assets/img/bg-appstore.webp` | | Cloud | `neode-ui/public/assets/img/bg-cloud.webp` | | Default | `neode-ui/public/assets/img/bg-intro.jpg` | | Transition | `neode-ui/public/assets/img/bg-intro-3.jpg` | | Intro 1–6 | `neode-ui/public/assets/img/bg-intro-1.webp` … `bg-intro-6.webp` (intro-2 and intro-3 remain `.jpg` — WebP came out larger for those) | --- ## Steps to Replace 1. Put your images in `neode-ui/public/assets/img/` with the exact filenames above. 2. For an intro replacement, update the matched poster/video pair above and its revision. 3. Run `npm run build` (or deploy) so the new assets are included. Dashboard background replacements need no code changes. Intro media revisions are maintained in `src/utils/introMedia.ts`. ## Intro typeface The opening sentences and “Welcome Noderunner” use locally bundled Share Tech Mono (`fonts/ShareTechMono/ShareTechMono-Regular.ttf`). Its license is included alongside the font. No external font service is required. The font is warmed before typing starts. Complete words and rows reserve layout space while characters appear, and the cursor follows the last revealed glyph. The welcome reveal uses continuous motion within a fixed-width container.