podverse/routing-url-params

Routing URL Params

Instructions

• Do not auto-insert query params into the URL on initial render.
• Only keep query params if the user navigated with them (typed or landed on a URL containing them).
• When params are at default values, remove them from the URL (e.g., page=1, sort=recent).
• Keep internal state for defaults; only reflect non-defaults in the URL.
• Apply this rule consistently across all pages (add-by-RSS and non-add-by-RSS).

Defaults and clearing

• If page is 1, it should not appear in the URL.
• If sort is the default (e.g., recent), it should not appear in the URL.
• If a user changes filters back to defaults, clear those params from the URL.

Pagination and sorting behavior

• Pagination and sorting should still work even when the URL is clean.
• When the user explicitly changes filters/pagination, update internal state first; only update the URL if the value is non-default.

Examples

Good (clean URL)

• /episodes (defaults: page 1, sort recent)

Good (user-specified)

• /episodes?page=2&sort=oldest

Good (clear defaults after change)

• User selects recent sort → remove sort param.
• User returns to page 1 → remove page param.

Bad (auto-inserting defaults)

• /episodes?page=1&sort=recent after initial load