state-in-url

Description

State Management & URL Synchronization

Use query parameters to persist any user state—think of JSON embedded in a browser URL. The library maintains data types and structure, so numbers remain numbers, dates stay dates, and objects or arrays are fully supported. It is lightweight, fast, and offers static TypeScript validation, making deep links (URL synchronization) straightforward.

The package includes:

• useUrlState hooks for Next.js and react‑router
• Helper utilities for any JavaScript environment

Modern browsers accommodate lengthy URLs, and users are comfortable with copy‑and‑paste workflows involving query strings. This library enables you to leverage the query string for state management exactly as intended, handling all routine tasks automatically.

It serves as a solid alternative to NUQS.

Key Features

• Store unsaved form data or page filters directly in the URL
• Keep React state synchronized with the URL
• Share application state across unrelated components without modifying the URI
• Create shareable URLs that reflect current app state (deep linking, URL sync)
• Persist state seamlessly through page reloads

Creator

Aleksandr Smyshliaev