How rushb-fr/freekiosk works
FreeKiosk is an Android kiosk platform with a React Native control UI and Kotlin system-control layer. The main workflow is configuring a kiosk, persisting settings, and running the selected WebView, external-app, or dashboard experience under device lockdown; REST, MQTT, and optional cloud fleet management extend that runtime. The map preserves documented scheduling, media, printing, and managed-app capabilities. Some implementation links rely on README statements or SOURCE INDEX references because their source was not excerpted.
Main entry points: KioskScreen.tsx Kiosk runtime · MainActivity.kt Android activity · storage.ts Configuration storage · AppNavigator.tsx App navigation
Components 21
Kiosk experience
- App navigation
src/navigation/AppNavigator.tsx - Kiosk runtime
src/screens/KioskScreen.tsx - WebView mode
src/components/WebViewComponent.tsx - Dashboard mode
src/types/dashboard.ts - Media player
src/types/mediaPlayer.ts - Managed apps
src/types/managedApps.ts
Configuration and control
- Settings UI
src/screens/settings/SettingsScreenNew.tsx - Blocking overlays
android/app/src/main/java/com/freekiosk/BlockingOverlayManager.kt - Screen scheduler
src/types/screenScheduler.ts - Configuration storage
src/utils/storage.ts - Secure credentials
src/utils/secureStorage.ts - Device control service
src/services/DeviceControlService.ts
Android enforcement
- Kiosk native module
android/app/src/main/java/com/freekiosk/KioskModule.kt - Android activity
android/app/src/main/java/com/freekiosk/MainActivity.kt - Kiosk watchdog
android/app/src/main/java/com/freekiosk/KioskWatchdogService.kt - Overlay service
android/app/src/main/java/com/freekiosk/OverlayService.kt
Automation and fleet
- REST API
src/utils/ApiService.ts - MQTT integration
android/app/src/main/java/com/freekiosk/mqtt/KioskMqttClient.kt - Cloud fleet sync
src/utils/CloudSyncService.ts - Silent printing
android/app/src/main/java/com/freekiosk/printing/SilentPrintModule.kt
Other components
- Device operator
Connections 25
- Device operator → App navigation: opens app
README.md - App navigation → Kiosk runtime: starts at
src/navigation/AppNavigator.tsx - App navigation → Settings UI: routes to
src/navigation/AppNavigator.tsx - Kiosk runtime → WebView mode: renders mode
src/screens/KioskScreen.tsx - Kiosk runtime → Configuration storage: loads settings
src/screens/KioskScreen.tsx - Settings UI → Configuration storage: persists settings
src/screens/settings/SettingsScreenNew.tsx - Configuration storage → Secure credentials: stores credentials
src/utils/storage.ts - Kiosk runtime → Kiosk native module: controls kiosk
src/screens/KioskScreen.tsx - Android activity → Kiosk native module: hosts module
android/app/src/main/java/com/freekiosk/MainActivity.kt - Android activity → Kiosk watchdog: starts service
android/app/src/main/java/com/freekiosk/MainActivity.kt - Kiosk watchdog → Android activity: relaunches
android/app/src/main/java/com/freekiosk/KioskWatchdogService.kt - Android activity → Overlay service: starts service
android/app/src/main/java/com/freekiosk/MainActivity.kt - Android activity → Blocking overlays: uses manager
android/app/src/main/java/com/freekiosk/MainActivity.kt - Kiosk runtime → Device control service: controls device
src/screens/KioskScreen.tsx - Kiosk runtime → Dashboard mode: supports mode
README.md - Kiosk runtime → Media player: supports mode
README.md - Kiosk runtime → Managed apps: supports apps
README.md - Settings UI → Screen scheduler: configures schedule
src/screens/settings/SettingsScreenNew.tsx - Device operator → REST API: configures remotely
README.md - REST API → Device control service: controls device
- Device operator → MQTT integration: integrates automation
README.md - Device operator → Cloud fleet sync: opts into fleet
README.md - Cloud fleet sync → Configuration storage: applies config
src/utils/CloudSyncService.ts - Cloud fleet sync → Secure credentials: loads credentials
src/utils/CloudSyncService.ts - Kiosk runtime → Silent printing: supports printing
README.md