What is node-fullykiosk?
node-fullykiosk is a TypeScript-friendly React Hooks library that provides a modern interface to interact with the Fully Kiosk Browser API. It wraps the native Fully Kiosk Browser JavaScript API in intuitive React hooks, making it easy to build kiosk applications with React.
Instead of directly accessing the global fully object injected by Fully Kiosk Browser, this library provides:
- Type-safe hooks with full TypeScript support
- Automatic event binding and cleanup for device state changes
- React-friendly patterns that work seamlessly with your component lifecycle
- Zero dependencies - only requires React as a peer dependency
What is Fully Kiosk Browser?
Fully Kiosk Browser is a powerful Android application that turns tablets and smartphones into dedicated kiosk displays. It’s commonly used for:- Digital signage
- Interactive displays
- Smart home control panels
- Information kiosks
- Point-of-sale terminals
Key Features
Device Information
Access device details like battery level, display size, network info, and device identifiers
Hardware Control
Control screen brightness, manage WiFi/Bluetooth, and interact with the keyboard
Event Handling
React to device events like battery changes, charging status, and network connectivity
Advanced Features
Use QR scanning, NFC reading, and screen orientation detection
When to Use This Library
Usenode-fullykiosk when you’re building a React application that will run inside Fully Kiosk Browser and you need to:
- Monitor device status (battery, charging, network)
- Control device hardware (screen brightness, WiFi, Bluetooth)
- Respond to device events in your React components
- Access device information (display size, orientation, device IDs)
- Use advanced features like QR code scanning or NFC
This library is designed specifically for React applications running inside Fully Kiosk Browser. The hooks will return
undefined when not running in the Fully Kiosk environment, allowing you to test your application in a standard browser.Available Hooks
The library provides over 20 hooks covering various device capabilities:- Device Info:
useDeviceName,useDeviceId,useAndroidId,useImei,useSerialNumber - Network:
useWifi,useWifiSSID,useWifiSignalLevel,useIpv4Address,useIpv6Address,useHostname - Power:
useBatteryLevel,useCharging - Display:
useDisplaySize,useOrientation,useScreenBrightness,useScreenRotationLock,useScreenSleep - Input:
useKeyboard - Connectivity:
useBluetooth - Scanning:
useQRScanner - Locale:
useCurrentLocale - Network Info:
useMacAddress
Next Steps
Installation
Install the library and set up your development environment