All Docs
FeaturesDepositClearUpdated March 11, 2026

Shareable, Bookmarkable List Views

Shareable, Bookmarkable List Views

Available from v0.1.161

Overview

Filter and view preferences on all major list pages — Tenancies, Check-Ins, Check-Outs, and similar — are now reflected in the page URL. This means any filtered or sorted view can be bookmarked, shared as a link, or restored after a page refresh without any loss of state.

What is synced to the URL

The following controls write their current value into URL search parameters automatically:

ControlURL param example
View mode (grid / table)?view=grid
Status filter?status=Disputed
Sort field & direction?sortBy=deposit&order=desc
Search query?search=jones
Pagination offset?offset=20

The URL is updated with router.replace (no scroll jump) every time you change any of these controls.

Reading state on load

When a list page loads it resolves the initial state in this order:

  1. URL search params — highest priority; used when a link or bookmark is followed.
  2. localStorage — fallback for users navigating to the page directly without URL params.
  3. Defaults — applied when neither source has a value.

This means users who arrive via a shared link see exactly what the sender saw, while users who navigate from the sidebar still get their personal last-used preferences.

Common use cases

Sharing a filtered view with a colleague

  1. Apply the filters and sort order you want to share (e.g. Status: Disputed, Sort: Deposit ↓).
  2. Copy the URL from your browser address bar — it now encodes all active filters.
  3. Send the URL. Your colleague opens it and sees the identical filtered, sorted list.

Bookmarking a recurring view

  1. Configure the list exactly as you use it day-to-day (e.g. View: Table, Status: Active, Sort: Move-out date ↑).
  2. Bookmark the URL in your browser.
  3. Opening the bookmark restores that view instantly — no need to reapply filters each session.

Back-button navigation

Because filter state lives in the URL, the browser's back button correctly returns you to the previous filter state after navigating into a tenancy detail page and then going back.

Notes

  • The URL is updated with scroll: false so the page does not jump when filters change.
  • localStorage continues to persist preferences for direct (non-linked) navigation.
  • No action is required from users — the behaviour is automatic on all affected list pages.