Skip to main content

Command Palette

Navigate TRMNL like a pro.

Ryan Kulp avatar
Written by Ryan Kulp
Updated this week

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.

Did this answer your question?