Do you like hotkeys? We like hotkeys.
While logged into the web application, press cmd+k
(Mac) or ctrl+k
(Windows/other) to open the command palette.
Navigate the application
Top level pages like Playlists, Devices, Dashboard, Account are accessible with a few leading characters from their page name.
After finding a match, hit enter
on your keyboard to jump to that page. Or use the direction arrows to select a different page.
Find design documentation
Look up Framework docs by keyword or utility name.
Scoping your queries
Page navigation and resource lookups are different behaviors. You may not want search results from one query to clutter your palette with unrelated items.
To resolve this, use option+tab
(Mac) or alt+tab
(Windows/other) to scope results to a specific "provider."
For example, here we're searching ima
(for image related docs) but our palette includes navigation helpers that we don't need.
By navigating to the "Documentation" provider with option+tab
, note the highlighted resource in the top-right of the palette changes. Now the same query yields more helpful results.
Nested queries
TRMNL is a relatively simple platform with parent and child objects. Plugins have plugin "instances," an Account has multiple Devices. Your Playlist has multiple Items.
To navigate to a specific device, you can execute multiple queries in sequence to both scope the results and perform tighter navigation.
For example, here we're querying just dev
in the search bar:
But these results include additional items we don't need. Note the "Show all" feature, triggered by the tab
key. Here's what happens when we press it.
This scopes results only to Device records, making it easier to navigate to a specific device. But that's not all. When reviewing a specific device, a new "Switch" feature appears, also triggered by the tab
key.
By first digging into our Devices records to scope results, then inputting a partial device name, we can now set this device as our "current device" without navigating away from the current page.
Nested query operations keep you in the same place, while also letting you modify your account.
Editing plugin settings
Coming soon. Similar to nested Device query operations, the intent here is to let you jump directly to plugin instances settings pages, or even perform other operations such as delete, export to Zip, and so on.
Stay tuned, and stay focused.