5.2 KiB
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
- Put your images in
neode-ui/public/assets/img/with the exact filenames above. - For an intro replacement, update the matched poster/video pair above and its revision.
- 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.