navigation-and-page-structure

SkillDev tools

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.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the navigation-and-page-structure skill

What this skill tells your AI

The instructions your AI receives, as published by hoangsonww/petswipe-match-app in .agents/skills/navigation-and-page-structure/SKILL.md and read by ahel’s review.

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.

Signals

GitHub stars
26
Forks
12
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
navigation-and-page-structure
Source
github.com/hoangsonww/petswipe-match-app