# Navigation And Page Structure

> PetSwipe navigation workflow for navbar changes, icon-only links, mobile menu behavior, route placement, and page discoverability. Use when work changes the navbar, mobile navigation, page ordering, or the relationship between key user-facing pages.

- Skill: `hoangsonww/navigation-and-page-structure` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add hoangsonww/navigation-and-page-structure`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hoangsonww/navigation-and-page-structure/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: hoangsonww (https://skillmd.com/u/hoangsonww)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hoangsonww/navigation-and-page-structure

---


Use this skill for navigation and page-structure work.

## Workflow

1. Identify the affected route, page, and navigation surface.
2. Check both desktop and mobile navigation behavior.
3. Preserve consistent ordering and discoverability between related pages.
4. If the change is icon-only or compact, verify tooltips and mobile equivalents still make sense.
5. Update docs if the page lineup or major product surface changes.

## Repo-Specific Guidance

- `frontend/components/Navbar.tsx` is the primary shared navigation surface.
- The app has multiple non-trivial page surfaces now, including `map`, `insights`, `adoption-planner`, `liked-swipes`, and `my-pets`.
- Mobile navbar quality matters because overflow has already been a recurring problem in this repo.

Read `references/navigation-checklist.md`.