Se você desenvolve com React ou Next.js, sabe que gerenciar filtros, paginação e busca através da URL (query strings) pode ser um verdadeiro "boilerplate hell".
Muitas vezes acabamos criando estados locais que ficam dessincronizados com a barra de endereços, ou pior: perdemos a tipagem do TypeScript ao tentar converter strings da URL em números, booleanos ou objetos.
É aqui que entra o nuqs (antigo next-usequerystate). 🛠️
O nuqs transforma a sua URL em uma "Single Source of Truth" (Fonte Única da Verdade) com a mesma facilidade do useState.
Por que você deveria testar:
✅ Type-safe: Parsers integrados para números, datas, JSON e até integração com Zod.
✅ Sincronização reativa: Atualize o estado e a URL muda instantaneamente (e vice-versa).
✅ Performance: Suporta atualizações "shallow" (sem recarregar a página inteira) e transições suaves.
✅ Shareability: Facilita muito para o usuário copiar um link e enviar para outra pessoa já com todos os filtros aplicados.
Se você quer um código mais limpo e uma UX de navegação muito mais sólida, o nuqs é indispensável na sua stack atual de Next.js.
🔗 Confira em: https://nuqs.dev/
Top comments (0)