Virtual.ink documentation

Quick Nav

Quick Nav is the customizable shortcut bar that sits above the main content area in the desktop app. It lets operators jump between favorite pages and, when supported, directly open a specific UI preset.

The Quick Nav editor appears as the Quick Nav page in the Config section of the desktop app. It is not exposed as a standalone public web page.

How Quick Nav Is Organized

Quick Nav works from presets.

Each preset stores:

a preset name
up to 9 shortcut items
a hidden flag

Each shortcut item stores:

a target page or component id
an optional UI preset id
an optional custom label

If no custom label is set, Quick Nav uses the normal page label. If a UI preset is attached, the default label becomes Page - Preset.

What The Quick Nav Page Lets You Do

Use the Quick Nav page to:

choose the active preset
create a new preset
duplicate a preset
rename a preset
delete a preset
hide the visible bar while keeping shortcuts active
reorder and edit items
attach UI presets when a page supports them
override the display label for an item

Virtual.ink currently ships with default Studio and Event Quick Nav presets in its app defaults.

The shipped Studio preset emphasizes dashboard, review, render, naming, and device work. Event brings Share forward for guest-facing sessions while keeping the same core operator pages nearby.

Keyboard Shortcuts

The active Quick Nav preset is mapped to:

Ctrl+1 through Ctrl+9

Shortcut behavior:

each digit triggers the matching item in the active preset
shortcuts are ignored while focus is in an input, textarea, select, or editable field
an item can navigate to a page alone or to a page plus a specific UI preset

If a preset is marked Hidden, the visible bar disappears but the keyboard shortcuts still work.

Limits And Validation

each preset can contain a maximum of 9 items
labels are optional
UI preset selectors only appear for pages that actually expose UI presets
if a saved UI preset no longer exists, the editor keeps the stale value visible until you replace it

Storage And Reset

Quick Nav settings are loaded from and saved to the app server through /api/quicknav.

Current live Quick Nav settings are stored with the app's saved settings. Shipped defaults come from Virtual.ink's app-defaults.json.

Virtual.ink exposes two reset paths:

Reset Quick Nav in Troubleshooting restores the current shipped defaults
a local desktop-only factory action can push the current Quick Nav layout back into shipped defaults for future resets

When To Use Quick Nav

Quick Nav is most useful when you need:

fast switching between recurring operator pages
different navigation sets for studio versus event work
keyboard-first navigation without reopening the full shell menu