Fullscreen Kiosk Mode

Automatic fullscreen mode for immersive kiosk experience:

• Automatic Activation: Browser enters fullscreen automatically after PIN verification
• Kiosk Lock: Prevents users from exiting fullscreen easily
• Escape Prevention: Escape key and F11 blocked when locked
• Right-Click Block: Context menu disabled when locked
• Auto Re-entry: Automatically re-enters fullscreen if exited
• Developer Unlock: Press Ctrl+Shift+K to unlock (staff only)
• Cross-Browser: Works with standard, webkit, moz, and ms fullscreen APIs
• Use Cases: Perfect for in-store displays, dedicated kiosks, trade shows

Customization & Theming

Customize kiosk appearance:

• Store Logo: Upload logo to replace store name in app bar
• Theme Toggle: Users can switch between light and dark themes
• System Preference: Defaults to system preference on first load
• Theme Persistence: Theme choice saved in browser localStorage
• Color Scheme: Uses SortSwift brand colors (#3EACFD primary, #3E6AFD secondary)
• Typography: Manrope font with optimized weights and spacing
• Responsive: Layout adapts to screen size automatically

Security & Authentication

Security features and authentication:

• PIN Authentication: 6-digit PIN required for access
• Server-Side Verification: PIN verified against configured passcode
• Location Tracking: IP geolocation captured during PIN verification
• Identifying Data: Browser info, platform, timezone, screen resolution collected
• Audit Logging: Every PIN verification logged with location and metadata
• Discord Notifications: Real-time webhook notifications for PIN usage
• Subscription Check: Requires active subscription
• Read-Only Access: Kiosk has no admin functions or modification capabilities

Inventory Visibility

Control what inventory appears in the kiosk:

• In-Stock Filter: Toggle to show only in-stock items (default) or all items
• Product Types: Filter by Singles, Sealed, Custom, or All
• Card Scans: Toggle high-resolution card scan visibility
• Owner Matching: Only shows products owned by kiosk store
• Stock Aggregation: Combines stock from multiple entries per variant
• Price Display: Uses variant-specific price or falls back to product-level pricing
• Availability Rules: Items must have quantity > 0 and not be deleted
• Real-Time Updates: Inventory changes reflect immediately
• Cart Reservations: Available quantity accounts for items in cart

Security Limitations

Important security considerations:

• Browser-Based: Security relies on browser and localStorage
• PIN Storage: Verified PIN stored in localStorage (not encrypted)
• Client-Side State: Lock state can be manipulated in browser
• VPN Bypass: Location tracking can be spoofed with VPN
• Not Production Auth: PIN is access control, not strong authentication
• Shared PINs: If PIN is shared, all users have access
• OS-Level Exit: System shortcuts (Alt+Tab, Cmd+Tab) still work

Best Practices

• Unique PINs: Use unique passcodes for each store location
• Regular Updates: Change PINs periodically for security
• Staff Training: Train staff on unlock method (Ctrl+Shift+K) for maintenance
• Physical Security: Use dedicated devices with physical security measures
• Monitor Usage: Review Discord notifications for suspicious activity
• Don't Share PINs: Keep PINs private from customers
• Browser Settings: Configure browser to auto-start kiosk URL
• Dedicated Devices: Use devices solely for kiosk display