All Docs
FeaturesDepositClearUpdated March 13, 2026

Tenancy Detail: Breadcrumb, List State & Tab Deep-Linking

Tenancy Detail: Breadcrumb, List State & Tab Deep-Linking

Released in v0.1.267

Three navigation improvements have been made to the tenancy detail page to reduce context-switching friction for agents managing large portfolios.

1. Persistent Breadcrumb

Every tenancy detail page now shows a breadcrumb at the top:

Tenancies → 123 High Street
  • Tenancies — a link back to the tenancy list. Clicking this restores the list exactly as you left it (see below).
  • 123 High Street — the current tenancy address. Non-interactive, provides orientation.

The breadcrumb is always visible regardless of which tab is active.

2. List State Restoration

The Problem

When you navigate from the Tenancies list into a detail page and then return, the list resets to page 1 with no filters applied. For agents filtering by landlord, status, or date range across dozens of tenancies, this meant repeatedly re-applying the same filters on every visit.

How It Works Now

When you click into a tenancy from the list, the current list URL — including all active filters, sort column, sort direction, and page number — is saved to sessionStorage.

When you click Tenancies in the breadcrumb, that saved URL is retrieved and you are returned to the list in exactly the state you left it.

Note: List state is stored per browser tab in sessionStorage. It is not persisted across tabs or after the browser session ends. Navigating directly to a tenancy detail URL (e.g. from a shared link) will not have a saved list state; the breadcrumb will return you to the default list view in that case.

3. Tab Deep-Linking

Available Tabs

The tenancy detail page contains six tabs:

TabURL ParameterPurpose
Timeline?tab=timelineFull event history for the tenancy
Check-in?tab=check-inCheck-in inspection report and media
Check-out?tab=check-outCheck-out inspection report and media
Compliance?tab=complianceCompliance documents and status
Deductions?tab=deductionsDeposit deduction claims and evidence

Behaviour

  • Clicking a tab updates the URL query parameter immediately.
  • The active tab is restored correctly on page load from a URL containing ?tab=.
  • Browser Back and Forward buttons navigate between tab states as expected.
  • Tab URLs can be bookmarked or shared — the recipient will land directly on the correct tab.

Example URLs

/dashboard/tenancies/abc123?tab=deductions
/dashboard/tenancies/abc123?tab=check-out
/dashboard/tenancies/abc123?tab=compliance

Affected File

  • src/app/dashboard/tenancies/[id]/tenancy-detail-view.tsx