archy/neode-ui/docs/GAMEPAD-NAV-MAP.md

Gamepad Navigation Map

Every arrow key, every position, every page.

[C] = Container (red tile, D-pad grid) [N] = Nav bar item (secondary, reached via Up from top row) [Y] = Inner control (entered via Enter on container, exited via Escape) [S] = Sidebar item

---

Sidebar (all pages)

Vertical list. Up/Down wrap. Right enters page. Left does nothing.

Position	Up	Down	Right	Left
Home	Logout	Apps	First [C]	nothing
Apps	Home	Cloud	First [C]	nothing
Cloud	Apps	Mesh	First [C]	nothing
Mesh	Cloud	Network	First [C]	nothing
Network	Mesh	Web5	First [C]	nothing
Web5	Network	Fleet	First [C]	nothing
Fleet	Web5	Settings	First [C]	nothing
Settings	Fleet	AIUI	First [C]	nothing
AIUI	Settings	Logout	First [C]	nothing
Logout	AIUI	Home	First [C]	nothing

---

HOME /dashboard

Nav bar [N]

[N] Dashboard    [N] Setup

Grid [C]

Row 1:  [C] My Apps       [C] Cloud
Row 2:  [C] Network       [C] Wallet
Row 3:  [C] System
Row 4:  [C] Quick Start   (full-width, if visible)

Position	Up	Down	Left	Right	Enter
[N] Dashboard	nothing	My Apps	nothing	Setup	Switch tab
[N] Setup	nothing	My Apps	Dashboard	nothing	Switch tab
My Apps	[N] bar	Network	Sidebar	Cloud	/dashboard/apps
Cloud	[N] bar	Wallet	My Apps	nothing	/dashboard/cloud
Network	My Apps	System	Sidebar	Wallet	/dashboard/server
Wallet	Cloud	nothing	Network	nothing	/dashboard/web5
System	Network	Quick Start	Sidebar	nothing	/dashboard/settings
Quick Start	System	nothing	Sidebar	nothing	Drill into [Y]

Quick Start [Y] inner controls

[Y] Open a Shop    [Y] Accept Payments    [Y] File Browser

Position	Left	Right	Escape
Open a Shop	nothing	Accept Payments	Back to [C]
Accept Payments	Open a Shop	File Browser	Back to [C]
File Browser	Accept Payments	nothing	Back to [C]

---

APPS /dashboard/apps

Nav bar [N]

[N] My Apps  [N] App Store  [N] Services  |  [N] All  [N] Bitcoin  [N] Social (etc)  |  [N] Search

Three groups: page tabs, category filters (dynamic), search input.

Position	Up	Down	Left	Right	Enter
[N] My Apps	nothing	App1	nothing	App Store	Switch tab
[N] App Store	nothing	App1	My Apps	Services	/dashboard/discover
[N] Services	nothing	App1	App Store	All filter	Switch tab
[N] All	nothing	App1	Services	Bitcoin (etc)	Filter
[N] Search	nothing	App1	last filter	nothing	Type text

Grid [C] (3-col)

Row 1:  [C] App1    [C] App2    [C] App3
Row 2:  [C] App4    [C] App5    [C] App6
(etc)

Position	Up	Down	Left	Right	Enter
App1 (row 1)	[N] bar My Apps	App4	Sidebar	App2	Launch app
App2 (row 1)	[N] bar My Apps	App5	App1	App3	Launch app
App3 (row 1)	[N] bar My Apps	App6	App2	nothing	Launch app
App4 (row 2)	App1	App7	Sidebar	App5	Launch app
App5 (row 2)	App2	App8	App4	App6	Launch app
App6 (row 2)	App3	App9	App5	nothing	Launch app
(etc)	above	below	left/side	right	Launch app

App [Y] inner controls (if no launch action)

[Y] Stop    [Y] Restart    [Y] Uninstall

Escape exits back to [C] app card.

---

CLOUD /dashboard/cloud

No nav bar.

Grid [C] (3-col)

Row 1:  [C] Photos      [C] Music       [C] Documents
Row 2:  [C] Files        [C] Peer1       [C] Peer2 (etc)

Position	Up	Down	Left	Right	Enter
Photos	nothing	Files	Sidebar	Music	Open section
Music	nothing	Peer1	Photos	Documents	Open section
Documents	nothing	Peer2	Music	nothing	Open section
Files	Photos	nothing	Sidebar	Peer1	Open section
Peer1	Music	nothing	Files	Peer2	Open peer files
Peer2	Documents	nothing	Peer1	nothing	Open peer files

---

NETWORK /dashboard/server

No nav bar.

Grid [C] (2-col)

Row 1:  [C] Local Network    [C] Web3
Row 2:  [C] Quick Actions (etc)

Position	Up	Down	Left	Right	Enter
Local Network	nothing	Quick Actions	Sidebar	Web3	Drill into [Y]
Web3	nothing	Quick Actions	Local Net	nothing	Drill into [Y]
Quick Actions	Local Net	nothing	Sidebar	nothing	Drill into [Y]

---

WEB5 /dashboard/web5

No nav bar. Containers from child components stacked vertically + side-by-side.

Grid [C]

Row 1:  [C] Action1  [C] Action2  [C] Action3  [C] Action4  [C] Action5  [C] Action6
Row 2:  [C] Wallet              [C] Domains
Row 3:  [C] Nostr Relays        [C] Node Visibility
Row 4:  [C] Connected Nodes

Standard spatial grid nav. Left from leftmost = Sidebar. Enter = drill into [Y] controls.

---

DISCOVER /dashboard/discover

Nav bar [N]

[N] My Apps  [N] App Store  [N] Services  |  [N] Category filters (etc)

Grid [C] (3-col)

Row 0:  [C] Featured1    [C] Featured2    [C] Featured3
Row 1:  [C] App1         [C] App2         [C] App3
(etc)

Position	Up	Down	Left	Right	Enter
[N] tabs	nothing	Featured1	left tab	right tab	Switch/filter
Featured1	[N] bar	App1	Sidebar	Featured2	View details
App1	Featured1	App4	Sidebar	App2	Install
(etc)	above	below	left/side	right	Install

---

MESH /dashboard/mesh

Grid [C]

Row 1:  [C] Device Status    [C] Chat Panel
Row 2:  [C] Peers List       [C] Tab Panel (Bitcoin/Dead Man/Map)

Spatial grid nav. Enter = drill into controls.

---

FLEET /dashboard/fleet

Grid [C]

Row 1:  [C] Nodes    [C] Online    [C] Offline    [C] Health
Row 2:  [C] Node1    [C] Node2     [C] Node3      (etc)

Spatial grid nav. Enter = view node details.

---

SETTINGS /dashboard/settings

Grid [C] (vertical stack)

Row 1:  [C] Account Info
Row 2:  [C] Change Password
Row 3:  [C] Two-Factor Auth
Row 4:  [C] System Info
Row 5:  [C] Danger Zone

Position	Up	Down	Left	Right	Enter
Account Info	nothing	Change Password	Sidebar	nothing	Drill into [Y]
Change Password	Account Info	Two-Factor	Sidebar	nothing	Drill into [Y]
Two-Factor	Change Password	System Info	Sidebar	nothing	Drill into [Y]
System Info	Two-Factor	Danger Zone	Sidebar	nothing	Drill into [Y]
Danger Zone	System Info	nothing	Sidebar	nothing	Drill into [Y]

---

LOGIN /login

No sidebar, no grid. Three modes on the same route. [B] = Button [I] = Input field [L] = Link

Set Password (first visit after onboarding)

Auto-focus: [I] Password

[I] Password
[I] Confirm Password
[B] Set Password
[L] Replay Intro    [L] Restart Onboarding

Position	Up	Down	Left	Right	Enter
[I] Password	nothing	[I] Confirm	nothing	nothing	Type / Down
[I] Confirm	[I] Password	[B] Set Password	nothing	nothing	Type / Down
[B] Set Password	[I] Confirm	[L] Replay Intro	nothing	nothing	Submit
[L] Replay Intro	[B] Set Password	nothing	nothing	[L] Restart	Replay intro
[L] Restart	[B] Set Password	nothing	[L] Replay Intro	nothing	Restart onboarding

Normal Login

Auto-focus: [I] Password

[I] Password
[B] Login
[L] Replay Intro    [L] Restart Onboarding

Position	Up	Down	Left	Right	Enter
[I] Password	nothing	[B] Login	nothing	nothing	Type / Down
[B] Login	[I] Password	[L] Replay Intro	nothing	nothing	Submit
[L] Replay Intro	[B] Login	nothing	nothing	[L] Restart	Replay intro
[L] Restart	[B] Login	nothing	[L] Replay Intro	nothing	Restart

TOTP Verification (after password accepted)

Auto-focus: [I] TOTP Code

[I] TOTP Code
[B] Verify
[L] Use Backup Code

Position	Up	Down	Left	Right	Enter
[I] TOTP Code	nothing	[B] Verify	nothing	nothing	Type / Down
[B] Verify	[I] TOTP Code	[L] Backup Code	nothing	nothing	Submit
[L] Use Backup Code	[B] Verify	nothing	nothing	nothing	Toggle backup mode

---

ONBOARDING /onboarding/*

No sidebar, no grid. Sequential wizard screens. [B] = Button [I] = Input field [C] = Selectable card [L] = Link

Global onboarding rules:

• No sidebar or nav bar on any onboarding screen.
• First interactive element auto-focused on each screen (inputs when present, otherwise primary button).
• B button (Escape) = go back to previous onboarding step (where applicable).
• D-pad Up/Down always moves between focusable elements — inputs are never trapping. Up/Down exits a focused input to the adjacent element.
• Enter on an input = submit if it's the last field, otherwise move to next field.
• Enter activates the focused element.

---

INTRO /onboarding/intro

Default focus: [B] Unlock

[B] Unlock your sovereignty
[L] Restore from backup

Position	Up	Down	Left	Right	Enter
[B] Unlock	nothing	[L] Restore	nothing	nothing	→ /onboarding/path
[L] Restore	[B] Unlock	nothing	nothing	nothing	Show restore panel

Restore Panel [Y] (shown after activating Restore link)

[I] File picker
[I] Passphrase
[B] Cancel    [B] Restore

Position	Up	Down	Left	Right	Enter	Escape
[I] File picker	nothing	[I] Passphrase	nothing	nothing	Open file dialog	Close panel
[I] Passphrase	[I] File picker	[B] Cancel	nothing	nothing	Type / Down	Close panel
[B] Cancel	[I] Passphrase	nothing	nothing	[B] Restore	Close panel	Close panel
[B] Restore	[I] Passphrase	nothing	[B] Cancel	nothing	Submit restore	Close panel

---

PATH /onboarding/path

Default focus: [C] Fresh Start

[C] Fresh Start    [C] Restore (disabled)    [C] Connect (disabled)
[B] Continue

Position	Up	Down	Left	Right	Enter
[C] Fresh Start	nothing	[B] Continue	nothing	[C] Restore	Select option
[C] Restore	nothing	[B] Continue	[C] Fresh Start	[C] Connect	nothing (disabled)
[C] Connect	nothing	[B] Continue	[C] Restore	nothing	nothing (disabled)
[B] Continue	[C] Fresh Start	nothing	nothing	nothing	→ /login (complete)

---

OPTIONS /onboarding/options

Default focus: [C] Sovereignty

Row 1:  [C] Sovereignty     [C] Commerce       [C] Projects
Row 2:  [C] Transmitter     [C] Hoster         [C] AI
[B] Continue

Position	Up	Down	Left	Right	Enter
[C] Sovereignty	nothing	[C] Transmitter	nothing	[C] Commerce	nothing (display)
[C] Commerce	nothing	[C] Hoster	[C] Sovereignty	[C] Projects	nothing (display)
[C] Projects	nothing	[C] AI	[C] Commerce	nothing	nothing (display)
[C] Transmitter	[C] Sovereignty	[B] Continue	nothing	[C] Hoster	nothing (display)
[C] Hoster	[C] Commerce	[B] Continue	[C] Transmitter	[C] AI	nothing (display)
[C] AI	[C] Projects	[B] Continue	[C] Hoster	nothing	nothing (display)
[B] Continue	[C] Transmitter	nothing	nothing	nothing	→ /onboarding/did

---

DID /onboarding/did

Loading state: No interactive elements. Auto-advances when generation completes.

After generation:

Default focus: [B] Continue

[B] Copy DID
[B] Copy Nostr (if available)
[B] Continue

Position	Up	Down	Left	Right	Enter
[B] Copy DID	nothing	[B] Copy Nostr	nothing	nothing	Copy to clipboard
[B] Copy Nostr	[B] Copy DID	[B] Continue	nothing	nothing	Copy to clipboard
[B] Continue	[B] Copy Nostr	nothing	nothing	nothing	→ /onboarding/identity

If no Nostr ID: [B] Copy DID → Down → [B] Continue directly.

---

IDENTITY /onboarding/identity

Auto-focus: [I] Name

[I] Identity Name
[C] Personal    [C] Business    [C] Anonymous
[B] Continue

Position	Up	Down	Left	Right	Enter
[I] Name	nothing	[C] Personal	nothing	nothing	Type / Down
[C] Personal	[I] Name	[B] Continue	nothing	[C] Business	Select purpose
[C] Business	[I] Name	[B] Continue	[C] Personal	[C] Anonymous	Select purpose
[C] Anonymous	[I] Name	[B] Continue	[C] Business	nothing	Select purpose
[B] Continue	[C] Personal	nothing	nothing	nothing	→ /onboarding/backup

---

BACKUP /onboarding/backup

Auto-focus: [I] Passphrase

[I] Passphrase
[B] Download Backup
[B] Continue (disabled until downloaded)

Position	Up	Down	Left	Right	Enter
[I] Passphrase	nothing	[B] Download	nothing	nothing	Type / Down
[B] Download	[I] Passphrase	[B] Continue	nothing	nothing	Create & download backup
[B] Continue	[B] Download	nothing	nothing	nothing	→ /onboarding/verify

[B] Continue disabled (skip focus) until backup downloaded.

---

VERIFY /onboarding/verify

Phase 1 — Signing:

Default focus: [B] Sign Challenge

[B] Sign Challenge

Position	Up	Down	Left	Right	Enter
[B] Sign Challenge	nothing	nothing	nothing	nothing	Sign crypto challenge

Phase 2 — After verification:

Default focus: [B] Finish

[B] Finish

Position	Up	Down	Left	Right	Enter
[B] Finish	nothing	nothing	nothing	nothing	→ /onboarding/done

---

DONE /onboarding/done

Default focus: [B] Set Password

[C] Identity    [C] Backup    [C] Ready
[B] Set Password

Position	Up	Down	Left	Right	Enter
[C] Identity	nothing	[B] Set Password	nothing	[C] Backup	nothing (display)
[C] Backup	nothing	[B] Set Password	[C] Identity	[C] Ready	nothing (display)
[C] Ready	nothing	[B] Set Password	[C] Backup	nothing	nothing (display)
[B] Set Password	[C] Identity	nothing	nothing	nothing	→ /login

---

Onboarding & Login Rules

1. No sidebar or nav bar — linear wizard flow.
2. First interactive element auto-focused (input fields when present, otherwise primary button).
3. D-pad Up/Down always moves between focusable elements — inputs are never trapping. You can always D-pad out of a focused field.
4. Left/Right for horizontal card rows only.
5. Disabled elements are skipped in focus order.
6. B button (Escape) navigates back one onboarding step.
7. Enter on input: submits if last field, otherwise advances to next field.
8. No wrap — edges are dead stops.
9. No dead ends — every screen has a forward action.

---

Rules

1. Sidebar: Up/Down wrap. Right → first [C]. Left → nothing.
2. Grid: arrows move between [C] spatially. No wrap at edges.
3. Left from leftmost [C] → Sidebar active tab.
4. Up from top-row [C] → [N] nav bar (if page has one), else nothing.
5. Enter on [C]: has link → navigate. No link → drill into [Y].
6. Inside [Y]: arrows move between inner controls. Escape → back to [C].
7. Escape from [C] → Sidebar.
8. No dead ends.