Skip to content

feat(nav): restructure top menu — promote Get Started, drop "Network" dropdown#30

Merged
paulgnz merged 1 commit into
mainfrom
feat/nav-restructure
May 18, 2026
Merged

feat(nav): restructure top menu — promote Get Started, drop "Network" dropdown#30
paulgnz merged 1 commit into
mainfrom
feat/nav-restructure

Conversation

@paulgnz
Copy link
Copy Markdown
Collaborator

@paulgnz paulgnz commented May 18, 2026

Three problems with the previous nav:

  1. "Network ▾" dropdown contained "How It Works" alongside Validators and Arbitrators — a docs page mixed with entity-type pages.
  2. The word "Network" did double duty — the [mainnet] badge next to the logo is also called Network. Two concepts, same word.
  3. "Get Started" was buried in the user-avatar dropdown — only reachable after wallet connect. The home hero linked to it but the nav didn't surface it.

New structure

Logo · [mainnet]    Agents · Jobs · Get Started · How It Works · More ▾    Connect / Avatar ▾
                                                                ├ Leaderboard       ├ Dashboard
                                                                ├ Validators        └ Logout
                                                                └ Arbitrators
  • "Discover" → "Agents" (cleaner nav label; home H2 "Discover Agents" + footer link stay unchanged)
  • Get Started promoted to top-level — matches the home hero CTA, surfaces the page that now has a 3:29 video walkthrough
  • How It Works promoted to top-level — answers "what is this?"
  • Network dropdown removed. "More" dropdown takes its place but contains only entity directories (Leaderboard, Validators, Arbitrators) — no docs mixed in
  • Avatar dropdown: Dashboard + Logout (Get Started moves out)

Mobile: flat list, no nested dropdown. Primary + "MORE" label divider + secondary + Dashboard + Logout.

What's unchanged

  • Page type and activePage values byte-identical — no caller changes
  • NetworkBadge keeps its spot next to the logo. Now the only thing on the page using the word "Network"
  • Home H2 "Discover Agents" and footer "Discover Agents" link stay — natural pairing with the nav's shorter "Agents"

… dropdown ambiguity

The previous nav had three problems an audit didn't catch but the
operator-funnel did:

  1. "Network" dropdown contained "How It Works" alongside Validators
     and Arbitrators — a docs page mixed in with entity-type pages.
     Semantically inconsistent and hard to scan.
  2. The word "Network" was doing double duty — there's a `[mainnet]`
     badge right next to it labeled Network (the chain badge). Two
     different concepts using the same word.
  3. "Get Started" was buried in the user-avatar dropdown. The page
     literally for first-time visitors was only reachable AFTER they
     connected a wallet. The home hero CTA linked to it but a
     visitor scrolling the page couldn't see it in the nav.

## What changes

Primary nav (visible to logged-out visitors) now reflects the
conversion funnel directly:

  Logo · [mainnet]   Agents · Jobs · Get Started · How It Works · More ▾    Connect / Avatar ▾

- "Discover" → "Agents" (shorter, clearer label in the nav; the
  home page's "Discover Agents" H2 stays unchanged — pairs cleanly)
- "Get Started" promoted to top-level — matches the home hero CTA
- "How It Works" promoted to top-level — answers "what is this?"
- "Network" dropdown removed
- New "More" dropdown collects the secondary pages: Leaderboard,
  Validators, Arbitrators (entity directories only, no docs)
- Avatar dropdown: Dashboard + Logout (Get Started moves out)

## Mobile

Flat list, no nested dropdown for "More" — vertical space isn't
tight on mobile, and the previous expand-and-collapse pattern was
extra interaction for no benefit.

  - Primary: Agents, Jobs, Get Started, How It Works
  - "More" label + Leaderboard, Validators, Arbitrators (flat)
  - Dashboard (when logged in)
  - Connect / Logout

## What's unchanged

- The `Page` type and `activePage` values stay byte-identical. All
  existing pages keep working without any caller changes.
- The NetworkBadge ([mainnet]/[testnet] toggle pill) keeps its
  spot next to the logo. That's now the only thing on the page
  using the word "Network" — disambiguated.
- "Discover Agents" stays as the home page's H2 (action verb on
  the page) and the footer's link label. The nav's shorter
  "Agents" is the scannable abbreviation; both read naturally.

## Verification

- Frontend builds clean
- All 9 pages that pass `activePage` continue to highlight the
  correct nav item (the `MORE_PAGES` array tracks active state
  for the dropdown trigger like `NETWORK_PAGES` did before)
@paulgnz paulgnz merged commit acf9047 into main May 18, 2026
5 checks passed
@paulgnz paulgnz deleted the feat/nav-restructure branch May 18, 2026 22:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant