Skip to main content
skill CX Codex

implementing-navigation — Claude Code skill: how to install

implementing-navigation implements frontend navigation patterns and Python backend routing with built-in WCAG 2.1 AA accessibility guidelines.

MIT 1 installs ★ 533 updated 2025-12-11

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ancoleman/ai-design-components --skill implementing-navigation -a claude-code
Open on GitHub

What implementing-navigation does

This skill provides architecture guidelines for interface navigation, matching hierarchy depth with UI patterns. It details horizontal headers for flat structures with 5 to 7 links, multi-level sidebars for hierarchies with 3 or more levels, mega menus, breadcrumbs, and synchronized tabs. Client-side routing covers React Router and Next.js App Router, while touch layouts include hamburger drawers and bottom bars with 3 to 5 actions.

On the server side, the skill configures routes across Flask blueprints, Django URL patterns, and FastAPI routers. It provides utility scripts like node scripts/validate_navigation_tree.js to verify navigation trees and python scripts/generate_routes.py to produce route files from routes.yaml.

Running the included automation tools requires both Node.js and Python runtimes locally. Accessible interaction rules enforce explicit focus rings of at least 2px with 3:1 contrast, alongside keyboard controls for Tab, arrows, and Escape.

What it helps with

  • build accessible menus, tabs, and breadcrumbs for React and Next.js
  • organize server-side endpoints across Flask, Django, or FastAPI routers
  • implement keyboard navigation and ARIA roles meeting WCAG 2.1 AA
  • validate structured navigation trees against JSON schemas

Example prompts for the agent

  • Build a collapsible sidebar navigation for an admin dashboard using React Router
  • Configure FastAPI route structure using definitions from routes.yaml
  • Implement a mobile bottom navigation bar with keyboard focus trap

How to install implementing-navigation

1Skills CLI (Vercel)

npx skills add ancoleman/ai-design-components --skill implementing-navigation -a claude-code

2Manually: put the files in place

~/.claude/skills/implementing-navigation/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/implementing-navigation/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about implementing-navigation

How to install implementing-navigation in Claude Code?

Run npx skills add ancoleman/ai-design-components --skill implementing-navigation -a claude-code. The skill file installs to ~/.claude/skills/implementing-navigation/SKILL.md.

What does implementing-navigation do?

It guides coding agents through designing navigation components, keyboard accessibility, and routing setups across React and Python web frameworks.

Which backend frameworks are supported?

The skill includes templates and routing helpers for Flask, Django, and FastAPI.

Source text

SKILL.md · MIT
---
name: implementing-navigation
description: Implements navigation patterns and routing for both frontend (React/TS) and backend (Python) including menus, tabs, breadcrumbs, client-side routing, and server-side route configuration. Use when building navigation systems or setting up routing.
---

# Navigation Patterns & Routing Implementation

## Purpose

This skill provides comprehensive guidance for implementing navigation systems across both frontend and backend applications. It covers client-side navigation patterns (menus, tabs, breadcrumbs) and routing (React Router, Next.js) as well as server-side route configuration (Flask, Django, FastAPI).

## When to Use

Use this skill when:
- Building primary navigation (top, side, mega menus)
- Implementing secondary navigation (breadcrumbs, tabs, pagination)
- Setting up client-side routing (React Router, Next.js)
- Configuring server-side routes (Flask, Django, FastAPI)
- Creating mobile navigation patterns (hamburger, bottom nav)
- Implementing keyboard-accessible navigation
- Building command palettes or search-driven navigation
- Creating multi-step wizards or steppers
- Ensuring WCAG 2.1 AA compliance for navigation

## Navigation Decision Framework

```
Information Architecture → Navigation Pattern

Flat (1-2 levels)      → Top Navigation
Deep (3+ levels)       → Side Navigation
E-commerce/Large       → Mega Menu
Linear Process         → Stepper/Wizard
Long Content          → Table of Contents
Power Users           → Command Palette
Multi-section Page    → Tabs
Large Data Sets       → Pagination
```

## Frontend Navigation Components

### Primary Navigation Patterns

**Top Navigation (Horizontal)**
- Best for shallow hierarchies, marketing sites
- 5-7 primary links maximum for cognitive load
- See `references/menu-patterns.md` for implementation

**Side Navigation (Vertical)**
- Best for deep hierarchies, admin panels, dashboards
- Supports multi-level nesting and collapsible sections
- See `references/menu-patterns.md` for sidebar patterns

**Mega Menu**
- Best for e-commerce, content-heavy sites
- Rich content with images and descriptions
- See `references/menu-patterns.md` for mega menu structure

### Secondary Navigation Components

**Breadcrumbs**
- Shows hierarchical path and current location
- Essential for deep sites and e-commerce
- See `references/navigation-components.md` for breadcrumb patterns

**Tabs**
- Content switching without page reload
- URL synchronization for bookmarking
- See `references/navigation-components.md` for tab implementation

**Pagination**
- For search results, product lists, articles
- Consider virtualization for performance
- See `references/navigation-components.md` for pagination patterns

### Client-Side Routing

**React Router (Industry Standard)**
- Type-safe routing with loader patterns
- Nested routes and lazy loading support
- See `references/client-routing.md` for React Router patterns

**Next.js App Router**
- File-based routing with RSC support
- Parallel and intercepting routes
- See `references/client-routing.md` for Next.js routing

## Backend Routing Patterns

### Python Web Frameworks

**Flask**
- Blueprint-based organization
- Route decorators and URL rules
- See `references/flask-routing.md` for Flask patterns

**Django**
- URL configuration with namespaces
- Path converters and regex patterns
- See `references/django-urls.md` for Django URL conf

**FastAPI**
- Router-based organization
- Path operations and dependencies
- See `references/fastapi-routing.md` for FastAPI routers

## Mobile Navigation

### Patterns for Touch Devices

**Hamburger Menu**
- Slide-out drawer for primary navigation
- See `references/menu-patterns.md` for mobile drawer

**Bottom Navigation**
- 3-5 primary actions, thumb-friendly
- See `references/menu-patterns.md` for bottom nav

**Tab Bar**
- Horizontal scrollable tabs with swipe
- Natural for mobile-first applications

## Accessibility Requirements

### Keyboard Navigation

```
Tab       → Move forward through links
Shift+Tab → Move backward through links
Enter     → Activate link/button
Space     → Activate button
Arrow keys → Navigate within menus
Escape    → Close dropdowns/modals
```

### ARIA Patterns

Essential ARIA attributes for accessible navigation:
- See `references/accessibility-navigation.md` for complete ARIA patterns
- Includes landmark roles, states, and properties
- Screen reader optimization techniques

### Focus Management

- Visible focus indicators (2px minimum, 3:1 contrast)
- Focus trap for modals and dropdowns
- Skip navigation link for keyboard users
- See `references/accessibility-navigation.md` for focus patterns

## Implementation Utilities

### Navigation Structure Management

Generate and validate navigation trees:
```bash
# Validate navigation structure
node scripts/validate_navigation_tree.js nav-config.json

# Generate breadcrumb trails
node scripts/calculate_breadcrumbs.js current-path
```

### Route Generation (Python)

Generate route configurations:
```bash
# Generate Flask/Django/FastAPI routes
python scripts/generate_routes.py --framework flask --config routes.yaml
```

## Code Examples

### Frontend Examples

For working navigation implementations:
- `examples/horizontal-menu.tsx` - Responsive top navigation
- `examples/tab-navigation.tsx` - Tabs with URL sync
- `examples/mobile-navigation.tsx` - Hamburger and drawer

### Backend Examples

For routing configuration:
- `examples/flask_routes.py` - Flask blueprint setup
- `examples/django_urls.py` - Django URL patterns
- `examples/fastapi_routes.py` - FastAPI router organization

## Navigation Configuration

For complex navigation structures, use the configuration schema:
- `assets/navigation-config-schema.json` - Navigation tree schema
- `assets/route-templates.json` - Common route patterns

Validate configurations before implementation using the validation script.

## Library Recommendations

### Frontend Routing

**React Router** is the recommended solution for React applications:
- Industry standard with excellent TypeScript support
- Built-in accessibility with NavLink active states
- See `references/library-comparison.md` for alternatives

### Component Libraries

For rapid development, consider:
- Headless UI libraries (Radix UI, React Aria)
- Accessible by default
- Work with any styling approach

## Progressive Enhancement

Build navigation that works without JavaScript:
- Server-rendered HTML navigation
- Progressive enhancement with client-side routing
- Fallback for JavaScript failures

## Performance Considerations

- Lazy load route components
- Prefetch navigation targets
- Use route-based code splitting
- Implement loading states for navigation

## Testing Navigation

Essential navigation tests:
- Keyboard navigation flow
- Screen reader announcements
- Mobile touch interactions
- Route parameter validation
- Deep linking functionality

## Next Steps

1. Analyze the information architecture
2. Select appropriate navigation pattern
3. Implement with accessibility first
4. Add progressive enhancement
5. Test across devices and assistive technologies

For detailed implementation guides, explore the referenced documentation files based on specific requirements.

© ancoleman · MIT · ancoleman/ai-design-components

Similar skills

All skills for Frontend and UI →

From the same set10

The whole set →
visualizing-data visualizing-data picks the right chart for your data and purpose, then helps build the dashboard or report with accessibility baked in. CX Codex +1 2installs building-ai-chat building-ai-chat guides the design of AI chat interfaces with streamed replies, context controls, and image, file, or voice input. Use it when building an assistant or coding copilot. CX Codex +1 1installs architecting-networks architecting-networks is a Claude Code skill for choosing cloud network topologies: flat, multi-VPC, hub-and-spoke, or full mesh. It supports VPC, segmentation, and hybrid connectivity planning. CX Codex +1 1installs security-hardening The security-hardening skill tightens OS, container, cloud, network, and database settings. Use it before production deployment, audits, or vulnerability review. CX Codex +1 1installs implementing-observability The implementing-observability skill wires metrics, logs and traces through OpenTelemetry and shows how to run Loki, Grafana, Tempo and Mimir yourself. Useful once one request crosses several services. CX Codex +1 1installs ingesting-data ingesting-data is a Claude Code skill with design patterns and code recipes for importing data from cloud storage, APIs, files, and streams into databases. CX Codex +1 1installs configuring-firewalls The configuring-firewalls skill guides firewall configuration across Linux hosts, cloud security controls, and Kubernetes. Use it when opening a service or narrowing network access. CX Codex +1 1installs building-ci-pipelines building-ci-pipelines — a skill for constructing secure CI/CD pipelines with SLSA provenance, monorepo optimization, caching strategies, and test parallelization. Works with GitHub Actions, GitLab CI, and Argo Workflows. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open