React Router URL-Backed State
Use React Router search params as canonical filter or view state. Preserve sharing and back/forward behavior with stable encoding and no synchronization loops.
Choose which state should survive a reload or shared link. Search text, selected categories and page often belong in the URL. Uncommitted input, local animation and sensitive fields usually should stay local. Define a schema that parses known keys, defaults, allowed values and repeated fields, preserving unrelated query keys where the page does not own them. Apply the same interpretation to loaders and rendered controls. ## Key Points - [React Router useSearchParams](https://reactrouter.com/api/hooks/useSearchParams) - [WHATWG URL and URLSearchParams](https://url.spec.whatwg.org/)
skilldb get react-patterns-skills/react-router-search-paramsFull skill: 28 linesReact Router URL-Backed State
Choose which state should survive a reload or shared link. Search text, selected categories and page often belong in the URL. Uncommitted input, local animation and sensitive fields usually should stay local. Define a schema that parses known keys, defaults, allowed values and repeated fields, preserving unrelated query keys where the page does not own them. Apply the same interpretation to loaders and rendered controls.
Parse once and write through navigation
Read the current location as the canonical applied state. Build a deterministic serializer with consistent defaults and ordering. Preserve intentional value order when it matters. Avoid changing the URL just to write defaults unless canonicalization is a real requirement. With React Router useSearchParams, treat the returned object as mutable but avoid changing it in place. Copy it, compute the complete next state once and pass that to setSearchParams. Multiple callback updates in the same tick do not provide React state queue semantics.
Pick push versus replace according to user intent. Applying a new filter set may create a useful history entry; typing every character usually should not. Reset pagination atomically with an applied filter change. If text is debounced, keep the local draft distinct and resynchronize it on an external location change so a pending old draft cannot overwrite Back. Avoid a pair of effects that continuously copy URL and component state in both directions.
Test browser history and invalid input
Load a deep link, verify filters and results, change a filter, copy the resulting URL, and open it in a clean context. Navigate Back and Forward and confirm both controls and data follow the restored location. Exercise invalid enums, repeated values, unknown keys and query values with spaces or punctuation. Test two changes in one interaction and confirm neither is lost. Ensure missing or invalid inputs fall back safely without throwing or emitting an infinite replacement loop.
Retain URLs with synthetic data, expected query state and observed navigation calls. Do not put account tokens or sensitive search strings in sample URLs. A parse/serialize unit test does not prove actual history, loader behavior or a browser restoration path.
References and rights
Original SkillDB instructions under LicenseRef-SkillDB-Content. References were checked 2026-11-13 and used for technical verification.
Install this skill directly: skilldb add react-patterns-skills
Related Skills
Render Props
Render props pattern for sharing cross-cutting logic through function-as-children and render callbacks
Server Components
React Server Components pattern for zero-bundle server-rendered components with direct backend access
Suspense Patterns
React Suspense patterns for declarative loading states, data fetching, and code splitting
Canvas Image Editing and Masking in React
Implement a responsive React canvas image editor with nondestructive masks, reliable image-space coordinates, undo and consistent export.
Compound Components
Compound component pattern for building flexible, implicitly-shared React component APIs
Context Patterns
React Context patterns for efficient state sharing, provider composition, and avoiding unnecessary re-renders