filterable-data-page

Synchronize URL parameters with TanStack Query for React data pages.

Updated Feb 21, 2026
One-click install
npx skills add https://github.com/aquarius-wing/polymarket-dev-tools --skill filterable-data-page
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: filterable-data-page
Source: https://github.com/aquarius-wing/polymarket-dev-tools/tree/main/.cursor/skills/filterable-data-page
Command: npx skills add https://github.com/aquarius-wing/polymarket-dev-tools --skill filterable-data-page

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

URL-driven data pages with a single source of truth prevent duplicate requests and make sharing states easy, by coordinating URL parameters with a structured data fetch layer. For complex list pages with multiple filters and pagination, this pattern ensures consistent behavior and predictable UX.

Core Features & Use Cases

  • URL-driven state management with nuqs to synchronize page and all filters.
  • Three-layer architecture: Container handles URL + Query, Filter provides inputs, Display renders data.
  • TanStack Query integration to deduplicate requests and support shareable links.

Quick Start

Configure a new list page by wiring URL state with nuqs and load data via TanStack Query.

Frequently Asked Questions about filterable-data-page

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync React filter and pagination state with the URL?

To sync React filter and pagination state with the URL, use nuqs for state management. This coordinates URL parameters with a structured data fetch layer to maintain a single source of truth and produce shareable links.

What is the best way to prevent duplicate requests when filtering paginated data?

The best way to prevent duplicate requests when filtering paginated data is using TanStack Query integration. It deduplicates requests by relying on URL parameters as a single source of truth for page and filter states.

How do I build a shareable URL state for complex list pages in React?

Build shareable URL state for complex list pages by parsing URL parameters with nuqs and fetching data via TanStack Query. This pattern ensures consistent behavior, predictable UX, and easily shareable links.

Does TanStack Query work with nuqs for URL state management?

Yes, TanStack Query works with nuqs for URL state management. The integration uses a three-layer container, filter, and display architecture where the container handles URL parsing and query execution to deduplicate requests.

What architecture should I use for React pages with multiple filters and pagination?

For React pages with multiple filters and pagination, use a three-layer architecture: a Container handles URL and Query state, a Filter provides inputs, and a Display renders data. This ensures predictable UX.