Kiosk Mode & PIN

Stockaj Kiosk is designed to operate as a dedicated terminal, in fullscreen, without access to the operating system. Kiosk mode hides the navigation bar and locks the application.

Navigation Bar

In normal operation (outside kiosk mode), a navigation bar is displayed at the top of the screen:

Element	Position	Description
Stockaj Logo	Left	Link to the cockpit
Cockpit	Left	Link to the main screen (icon + text)
⚙️ Settings	Right	Access to configuration (PIN-protected if configured)

The navigation bar is hidden on the setup screen (/setup) and in kiosk mode.

---

PIN Protection

If a 4-digit PIN code is configured in the settings, it will be required in the following situations:

Action	PIN Required
Access settings (⚙️)	✅
Exit kiosk mode (Ctrl+Shift+Q or Escape)	✅
Use the cockpit	❌

PIN Dialog

PIN entry is done through a dedicated dialog with:

• 4 individual input fields (one per digit)
• A touch numeric keypad for kiosks without a keyboard
• Auto-submit when the 4th digit is entered
• Shake animation when an incorrect code is entered
• "Clear" and "Cancel" buttons

---

Kiosk Mode

Entering Kiosk Mode

Method	Description
Ctrl+Shift+K	Keyboard shortcut to enter kiosk mode

When kiosk mode is activated:

• The navigation bar is hidden — only the cockpit content and connection indicator remain visible
• The application occupies 100% of the screen
• The scanner remains active

Exiting Kiosk Mode

Method	Description
Ctrl+Shift+Q	Keyboard shortcut to exit kiosk mode
Escape	Escape key to exit kiosk mode

If a PIN code is configured, a dialog will prompt for the PIN before deactivating kiosk mode. Without a PIN, kiosk mode is deactivated immediately.

note

Kiosk mode resets on application restart. It is not persisted between sessions.

---

Keyboard Shortcuts

Shortcut	Action	PIN Required
Ctrl+Shift+K	Enter kiosk mode	❌
Ctrl+Shift+Q	Exit kiosk mode	✅ (if PIN configured)
Escape	Exit kiosk mode	✅ (if PIN configured)
Enter	Confirm selection / Close confirmation screen	❌
Space	Close confirmation screen	❌
↑ ↓	Navigate search results	❌

---

Fullscreen Configuration (Tauri)

The Tauri application is configured to start in fullscreen by default. These settings are defined in tauri.conf.json:

{
  "windows": [{
    "fullscreen": true,
    "decorations": false,
    "resizable": false,
    "alwaysOnTop": true,
    "skipTaskbar": true
  }]
}

Setting	Description
fullscreen: true	The application starts in fullscreen
decorations: false	No title bar or window borders
resizable: false	The window cannot be resized
alwaysOnTop: true	The window stays on top of all others
skipTaskbar: true	The application does not appear in the taskbar