Admin URL Deep Links
Admin URL Deep Links — ɳSelf documentation.
Every page in ɳSelf Admin serializes its tab, search, filter, and time-range state into URL search params. This means any admin view is directly shareable by copying the browser URL.
How It Works
Navigate to a page, set a filter or switch a tab, and the URL updates automatically. Copy that URL and send it to another operator, they land on the same view without extra clicks.
For example:
http://localhost:3021/monitor?tab=metrics&since=6hThis URL opens the Monitor page, selects the Metrics tab, and sets the time range to 6 hours.
Copying the Current URL
Every admin page shows a Copy link button in the top-right of the page header. Click it to copy the current URL (including all active filters) to your clipboard.
A brief toast confirms the copy:
“Link copied. Recipient must be signed in to view.”
The button is hidden in print mode. To suppress it on a specific page, pass showCopyLink={false} to <PageHeader>.
URL Parameters
| Param | Purpose | Example |
|---|---|---|
?tab=<name> | Active tab | ?tab=metrics |
?q=<text> | Search query | ?q=postgres |
?since=<duration> | Time-range filter | ?since=1h |
?filter.<key>=<value> | Arbitrary filter | ?filter.status=active |
?cursor=<opaque> | Pagination cursor | ?cursor=eyJpZCI6MTAwfQ |
?selected=<id> | Selected row ID | ?selected=abc123 |
Multiple params can be combined:
/monitor?tab=metrics&since=1h&filter.status=criticalBrowser Navigation
Switching tabs and applying filters does not create new browser history entries, the Back button takes you to the previous page, not the previous tab state. This is intentional: tab changes are considered view-state, not navigation.
Print Support
All admin pages include print styles that hide navigation elements and expand the main content to fill the page. To print a filtered view, apply your filters first, then use the browser print dialog (Cmd+P or Ctrl+P).
Sharing with Other Operators
Deep links are only useful to someone who has access to the same admin instance. ɳSelf Admin runs locally at localhost:3021: a URL copied from one machine will not work on a different machine unless both are on the same network and pointing at the same admin instance.
The copy-link toast includes a reminder: “Recipient must be signed in to view.”