You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -102,6 +102,28 @@ Esta biblioteca es una buena alternativa a NUQS.
102
102
-**Bien probada**: [Pruebas unitarias y pruebas de Playwright para Chrome/Firefox/Safari](https://github.com/asmyshlyaev177/state-in-url/actions/workflows/tests.yml)
103
103
-**Licencia permisiva**: MIT
104
104
105
+
### Comparación con nuqs
106
+
107
+
¿Buscas una alternativa a [nuqs](https://github.com/47ng/nuqs)? Ambas guardan estado tipado en la query string; difieren en cuánto hay que configurar y en qué puede ser un valor.
108
+
109
+
| Qué |`state-in-url`|`nuqs`|
110
+
| --- | --- | --- |
111
+
| Configuración | Ninguna — importa el hook y listo | Un componente adaptador envuelve la app |
112
+
| Forma del estado | Un objeto tipado, como `React.useState`| Valores por clave, con un parser declarado para cada una |
113
+
| Reutilización entre componentes | Envuelve el hook una vez — cada componente comparte el estado, sin props | Extraes tu propio hook alrededor del mapa de parsers |
114
+
| Objetos y arrays anidados | Integrado — estructura y tipos se conservan | Parser JSON más tu propio validador |
115
+
| Fechas | Se conservan automáticamente | Parser integrado, declarado por clave |
Tamaños: import de toda la librería, esbuild minify + gzip, medido en agosto de 2026 contra nuqs 2.10.1.
121
+
122
+
nuqs es una buena librería: elígela si quieres cada valor como su propio query param legible o usas TanStack Router. Elige state-in-url cuando quieras un objeto tipado completo en la URL sin configuración.
123
+
124
+
125
+
La comparación completa — la misma feature en ambas, otras alternativas (TanStack Router, use-query-params) y notas de migración — está en <https://state-in-url.dev/vs/nuqs>.
126
+
105
127
## Tabla de contenido
106
128
107
129
<!-- toc:start -->
@@ -111,6 +133,7 @@ Esta biblioteca es una buena alternativa a NUQS.
@@ -102,6 +102,28 @@ Cette bibliothèque est une bonne alternative à NUQS.
102
102
-**Bien testée** : [Tests unitaires et tests Playwright pour Chrome/Firefox/Safari](https://github.com/asmyshlyaev177/state-in-url/actions/workflows/tests.yml)
103
103
-**Licence permissive** : MIT
104
104
105
+
### Comparaison avec nuqs
106
+
107
+
Vous cherchez une alternative à [nuqs](https://github.com/47ng/nuqs) ? Les deux gardent un état typé dans la query string ; elles diffèrent par la configuration requise et par ce qu’une valeur peut être.
108
+
109
+
| Quoi |`state-in-url`|`nuqs`|
110
+
| --- | --- | --- |
111
+
| Mise en place | Aucune — importez le hook et c’est parti | Un composant adaptateur enveloppe l’application |
112
+
| Forme de l’état | Un objet typé, comme `React.useState`| Valeurs par clé, un parseur déclaré pour chacune |
113
+
| Réutilisation entre composants | Enveloppez le hook une fois — chaque composant partage l’état, sans props | Vous extrayez votre propre hook autour de la table de parseurs |
114
+
| Objets et tableaux imbriqués | Intégré — structure et types préservés | Parseur JSON plus votre propre validateur |
Tailles : import de la bibliothèque entière, esbuild minify + gzip, mesuré en août 2026 face à nuqs 2.10.1.
121
+
122
+
nuqs est une bonne bibliothèque — choisissez-la pour un query param lisible par valeur, ou si vous êtes sur TanStack Router. Choisissez state-in-url pour un objet typé complet dans l’URL, sans configuration.
123
+
124
+
125
+
La comparaison complète — la même fonctionnalité dans les deux, d’autres alternatives (TanStack Router, use-query-params) et des notes de migration — se trouve sur <https://state-in-url.dev/vs/nuqs>.
126
+
105
127
## Table des matières
106
128
107
129
<!-- toc:start -->
@@ -111,6 +133,7 @@ Cette bibliothèque est une bonne alternative à NUQS.
Copy file name to clipboardExpand all lines: README.md
+22Lines changed: 22 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -102,6 +102,27 @@ This library is a good alternative for NUQS.
102
102
-**Well tested**: [Unit tests and Playwright tests for Chrome/Firefox/Safari](https://github.com/asmyshlyaev177/state-in-url/actions/workflows/tests.yml)
103
103
-**Permissive license**: MIT
104
104
105
+
### Comparison with nuqs
106
+
107
+
Searching for a [nuqs](https://github.com/47ng/nuqs) alternative? Both keep typed state in the query string; they differ in how much you set up and what a value can be.
108
+
109
+
| What |`state-in-url`|`nuqs`|
110
+
| --- | --- | --- |
111
+
| Setup | None — import the hook and go | Adapter component wraps the app |
112
+
| State shape | One typed object, like `React.useState`| Per-key values, a parser declared for each |
113
+
| Reuse across components | Wrap the hook once — every component shares the state, no props | Extract your own hook around the parser map |
114
+
| Nested objects and arrays | Built in — structure and types preserved | JSON parser plus your own runtime validator |
Sizes: whole-library import, esbuild minify + gzip, measured August 2026 against nuqs 2.10.1.
121
+
122
+
nuqs is a fine library — reach for it when you want each value as its own readable query param, or you are on TanStack Router. Reach for state-in-url when you want a whole typed object in the URL with zero setup.
123
+
124
+
The full comparison — the same feature built in both, other alternatives (TanStack Router, use-query-params) and migration notes — lives at <https://state-in-url.dev/vs/nuqs>.
125
+
105
126
## Table of content
106
127
107
128
<!-- toc:start -->
@@ -111,6 +132,7 @@ This library is a good alternative for NUQS.
@@ -102,6 +102,28 @@ Esta biblioteca é uma boa alternativa ao NUQS.
102
102
-**Bem testada**: [Testes unitários e testes Playwright para Chrome/Firefox/Safari](https://github.com/asmyshlyaev177/state-in-url/actions/workflows/tests.yml)
103
103
-**Licença permissiva**: MIT
104
104
105
+
### Comparação com o nuqs
106
+
107
+
Procurando uma alternativa ao [nuqs](https://github.com/47ng/nuqs)? Ambas guardam estado tipado na query string; diferem em quanta configuração exigem e no que um valor pode ser.
108
+
109
+
| O quê |`state-in-url`|`nuqs`|
110
+
| --- | --- | --- |
111
+
| Configuração | Nenhuma — importe o hook e pronto | Um componente adaptador envolve o app |
112
+
| Formato do estado | Um objeto tipado, como `React.useState`| Valores por chave, com um parser declarado para cada uma |
113
+
| Reuso entre componentes | Envolva o hook uma vez — cada componente compartilha o estado, sem props | Você extrai seu próprio hook em volta do mapa de parsers |
114
+
| Objetos e arrays aninhados | Nativo — estrutura e tipos preservados | Parser JSON mais seu próprio validador |
Tamanhos: import da biblioteca inteira, esbuild minify + gzip, medido em agosto de 2026 contra o nuqs 2.10.1.
121
+
122
+
nuqs é uma boa biblioteca — prefira-o se quiser cada valor como seu próprio query param legível, ou se usa TanStack Router. Prefira state-in-url quando quiser um objeto tipado inteiro na URL sem configuração.
123
+
124
+
125
+
A comparação completa — a mesma feature nas duas, outras alternativas (TanStack Router, use-query-params) e notas de migração — está em <https://state-in-url.dev/vs/nuqs>.
126
+
105
127
## Índice
106
128
107
129
<!-- toc:start -->
@@ -111,6 +133,7 @@ Esta biblioteca é uma boa alternativa ao NUQS.
111
133
-[Por que usar `state-in-url`?](#por-que-usar-state-in-url)
0 commit comments