Skip to main content

Stockaj Kiosk

Stockaj Kiosk is a desktop application (Windows, macOS, Linux) designed to manage equipment checkout and return at festivals and events. It runs as a kiosk-mode terminal — fullscreen, distraction-free — and supports USB QR code / barcode readers.

Key Features​

FeatureDescription
🧭 CockpitRent, sell, return and consume equipment from a single screen with five modes
🔁 Rental & return sessionTake items back and lend new ones to the same volunteer in one confirmation
📋 What's out?A live table of every item currently out, with per-row and bulk return
✨ Assisted modeA large, step-by-step wizard for occasional or non-technical volunteers
🖨️ Label printingPrint volunteer and item QR labels to a Brother DK / label printer
📡 Offline modeOperations are queued and automatically synced when connectivity is restored
🔒 PIN protectionSettings and kiosk exit protected by an optional 4-digit PIN code
📱 QR / barcode scannerCompatible with any USB HID scanner (keyboard emulation)
🖥️ Kiosk modeFullscreen, hidden navigation, PIN-protected exit
🌐 Multi-languageInterface available in English and French

Architecture​

┌─────────────────────────────────────────────┐
│               Stockaj Kiosk                 │
│           (Tauri 2 — fullscreen)            │
│                                             │
│   React 18 + TypeScript + TailwindCSS       │
│   ┌─────────────┐  ┌────────────────────┐   │
│   │ Zustand      │  │ TanStack Query     │   │
│   │ (config,     │  │ (server data)      │   │
│   │  settings)   │  │                    │   │
│   └─────────────┘  └────────────────────┘   │
│                                             │
│   ┌─────────────────────────────────────┐   │
│   │ Offline queue (SQLite)              │   │
│   └─────────────────────────────────────┘   │
└─────────────────────────────────────────────┘
                      │
                      ▼
            Stockaj API (Laravel)
           https://app.stockaj.io

Application Screens​

After the one-time setup, the application has three working screens, reachable from the navigation bar:

  1. Cockpit — the main screen for renting, selling, returning and consuming equipment.
  2. What's out? — a live table of everything currently out, for quick lookups and returns.
  3. Assisted mode — a simplified, step-by-step checkout wizard.

A connection indicator and the app version are shown at the bottom left on every screen, and the navigation bar at the top switches between screens and opens the settings.

note

The What's out? and Assisted mode entries can be hidden from the navigation bar in the settings, so your terminal only shows the screens your team needs.

Prerequisites​

  • A Stockaj account with API access (https://app.stockaj.io/api/v1)
  • An API token (Bearer Token) generated from the Stockaj interface
  • (Optional) A USB QR code / barcode reader
  • (Optional) A Brother DK or compatible label printer

Quick Navigation​