towerops/docs
Graham McIntire 97b396a763
docs: add browser navigation best practices and design document
Add comprehensive documentation for idiomatic Phoenix LiveView URL state
management to ensure browser back/forward buttons work correctly.

Changes:
- Add design document: docs/plans/2026-02-12-browser-navigation-fix-design.md
  - Documents the problem (18 LiveViews missing handle_params/3)
  - Provides idiomatic Phoenix patterns using push_patch/2
  - Includes migration strategy for updating all LiveViews
  - Contains testing protocols and success criteria

- Update CLAUDE.md: Add "Browser Navigation and URL State Management" section
  - Documents the three core patterns: tabs, modals, filters
  - Establishes critical rules for all future LiveView development
  - Provides working code examples for each pattern
  - Links to official Phoenix documentation

Key Principles:
- URL is single source of truth for visible state
- Use push_patch/2 in event handlers, never assign for URL-backed state
- Always implement handle_params/3 to validate and process URL params
- Use Phoenix built-ins (no custom helpers needed)

This ensures future LiveView development follows the correct pattern
and browser navigation works as users expect.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-12 09:20:14 -06:00
..
features docs: add job monitoring dashboard feature documentation 2026-02-06 18:42:02 -06:00
librenms-audit docs: add comprehensive priority vendors analysis for LibreNMS parity 2026-02-12 08:49:32 -06:00
plans docs: add browser navigation best practices and design document 2026-02-12 09:20:14 -06:00
NIX-VERIFICATION.md feat: Add comprehensive Nix flakes integration 2026-02-07 12:26:54 -06:00
nix.md feat: Add comprehensive Nix flakes integration 2026-02-07 12:26:54 -06:00
README-nix-section.md feat: Add comprehensive Nix flakes integration 2026-02-07 12:26:54 -06:00