HMG_QLine/ANDROID_VS_WEB_COMPARISON.md

Android vs Web Platform Comparison

Quick reference for understanding differences between Android and Web versions
Last Updated: July 30, 2026

---

🔍 Platform Feature Comparison

Feature	Android (Current)	Web (After Migration)	Implementation Effort
Kiosk Mode	✅ Native Android kiosk mode	⚠️ Browser fullscreen + kiosk flags	Low
Auto-Start on Boot	✅ BootBroadcastReceiver	⚠️ Browser autostart config	Low
Wake Lock	✅ WakelockPlus plugin	✅ Browser Wake Lock API	Low
Screen Always On	✅ WindowManager flags	✅ Wake Lock API	Low
Background Service	✅ Foreground service	❌ Not possible (tab must stay open)	N/A
File Logging	✅ External storage	✅ IndexedDB + download	Medium
SignalR Real-time	✅ signalr_core	✅ Same (WebSocket)	None
Audio Playback	✅ just_audio	⚠️ just_audio web or HTML5 Audio	Low
Text-to-Speech	✅ flutter_tts	⚠️ Web Speech API	Medium
QR Scanner	✅ qr_code_scanner_plus	⚠️ mobile_scanner (requires HTTPS)	Low
Scheduled Tasks	✅ AlarmManager	⚠️ JavaScript timers	Medium
Offline Support	✅ Native app	⚠️ PWA with Service Worker	Medium
Push Notifications	✅ Firebase Cloud Messaging	⚠️ Web Push API	Medium
Network Detection	✅ connectivity_plus	✅ Same (web support)	None
Local Storage	✅ SharedPreferences	✅ localStorage (same plugin)	None
Multi-language	✅ Built-in	✅ Built-in	None
Updates	⚠️ Manual APK deployment	✅ Instant (refresh page)	N/A
Installation	⚠️ APK + ADB	✅ Just open URL	N/A
Security	✅ Full device control	⚠️ Browser sandbox	N/A
Crash Recovery	✅ Can restart automatically	⚠️ Browser dependent	Low

Legend:
✅ Fully Supported | ⚠️ Supported with Limitations | ❌ Not Supported

---

📦 Dependencies Comparison

Android-Only (Remove for Web)

# These will be removed
wakelock_plus: ^1.2.10          # Use Browser Wake Lock API instead
path_provider: ^2.1.5           # Use IndexedDB/localStorage instead
qr_code_scanner_plus: ^2.0.10+1 # Use mobile_scanner instead

Web-Compatible (Keep)

# These work on both platforms
provider: ^6.1.2               # ✅ State management
get_it: ^8.0.2                 # ✅ Dependency injection
signalr_core: ^1.1.1           # ✅ Real-time communication
connectivity_plus: ^6.1.0      # ✅ Network monitoring
shared_preferences: ^2.3.5     # ✅ Local storage
flutter_svg: ^2.0.14           # ✅ SVG rendering
intl: ^0.19.0                  # ✅ Internationalization
logger: ^2.4.0                 # ✅ Logging framework
http: ^1.2.2                   # ✅ HTTP requests

Web-Specific (Add)

# Add these for web support
mobile_scanner: ^3.5.2         # QR scanner with web support
indexed_db: ^0.3.0             # Structured data storage
universal_html: ^2.2.4         # Access to web APIs
js: ^0.6.7                     # JavaScript interop

Requires Testing/Replacement

just_audio: ^0.9.42            # ⚠️ Has web support, test needed
flutter_tts: ^4.2.0            # ⚠️ Limited web support, use Web Speech API

---

🔧 Code Changes Summary

Files That Need Changes

File	Type of Change	Complexity
lib/main.dart	Modify	Low - Add platform detection
lib/services/logger_service.dart	New File	Medium - Create web version
lib/services/wakelock_service.dart	New File	Low - Wrapper for web/mobile
lib/services/text_to_speech_service.dart	Modify	Medium - Add web implementation
lib/services/audio_service.dart	Modify	Low - Test or add web fallback
lib/utilities/native_method_handler.dart	Modify	Low - Add platform checks
lib/view_models/screen_config_view_model.dart	Modify	Medium - Add web lifecycle
lib/services/connectivity_service.dart	Modify	Low - Add IP detection for web
lib/config/dependency_injection.dart	Modify	Medium - Platform-aware DI
web/index.html	Create	Low - Standard web config
web/manifest.json	Create	Low - PWA manifest

Files That Don't Need Changes

File Category	Files	Reason
Models	All lib/models/*.dart	Platform-agnostic Dart code
Repositories	lib/repositories/*.dart	Use standard HTTP/SignalR
Constants	lib/constants/*.dart	Pure Dart constants
UI Widgets	Most of lib/views/*.dart	Flutter renders same
View Models	Business logic in ViewModels	Dart code, no platform API

Files to Delete (Not Needed for Web)

File	Reason
android/ folder	Android-specific native code
ios/ folder	iOS-specific native code
All .kt files	Kotlin is Android-only
qline_scripts/*.sh	Deployment scripts for Android APK

---

🚀 Deployment Comparison

Android Deployment (Current)

# Build
flutter build apk --release

# Deploy to devices
cd qline_scripts
sh deploy_qline.sh -ipfile device_ips_all.txt -version 9.4

# Update (requires ADB connection)
adb install -r app-release.apk

Pros:

• Full control over device
• Works offline always
• No browser dependencies

Cons:

• Manual deployment process
• Requires physical access or ADB
• Slower update rollout
• Version management complex

Web Deployment (After Migration)

# Build
flutter build web --release

# Deploy to Firebase (example)
firebase deploy

# Or deploy to own server
rsync -avz build/web/ user@server:/var/www/qline/

Pros:

• ✅ Instant updates (just refresh)
• ✅ Deploy once, available everywhere
• ✅ No APK management
• ✅ Central control
• ✅ Easy rollback

Cons:

• ⚠️ Requires internet for updates
• ⚠️ Browser must be configured
• ⚠️ HTTPS required for camera

---

🎯 Feature Parity Matrix

Core Features

Feature	Android	Web	Notes
Patient Queue Display	✅	✅	Identical
Real-time SignalR Updates	✅	✅	Identical
Audio Call Tones	✅	⚠️	Web: autoplay restrictions
TTS Announcements	✅	⚠️	Web: Web Speech API
Multi-language (EN/AR)	✅	✅	Identical
RTL Support	✅	✅	Identical
Weather Widget	✅	✅	Identical
Prayer Times Widget	✅	✅	Identical
RSS Feed Widget	✅	✅	Identical
Configuration via IP	✅	⚠️	Web: URL param or manual
Health Check Logging	✅	⚠️	Web: IndexedDB + download
Crash Logging	✅	⚠️	Web: Console + IndexedDB

Kiosk Features

Feature	Android	Web	Notes
QR Code Scanner	✅	⚠️	Web: Requires HTTPS
Manual ID Entry	✅	✅	Identical
Ticket Generation	✅	✅	Identical
Language Selection	✅	✅	Identical
Queue Selection	✅	✅	Identical
Thank You Screen	✅	✅	Identical

System Features

Feature	Android	Web	Notes
24/7 Operation	✅	⚠️	Web: Browser must stay open
Auto-restart	✅	⚠️	Web: Can reload page
Boot on Startup	✅	⚠️	Web: Configure browser autostart
Crash Recovery	✅	⚠️	Web: Browser dependent
Memory Management	✅	⚠️	Web: Browser handles
Log Rotation	✅	⚠️	Web: Manual download needed

---

💰 Cost Comparison

Android Deployment

Initial Costs:

• Android TV boxes/displays: $100-300 per device
• One-time setup per device
• ADB deployment setup

Ongoing Costs:

• Manual deployment time
• Physical access for updates
• Maintenance visits

Advantages:

• One-time cost
• No hosting fees
• Full offline operation

Web Deployment

Initial Costs:

• Thin clients/mini PCs: $150-400 per device (optional - can reuse existing)
• SSL certificate: Free (Let's Encrypt)
• Domain name: $10-15/year

Hosting Options:

• Firebase Hosting: Free (up to 10GB)
• Self-hosted: Server costs
• Cloud (AWS/Azure): $20-100/month

Ongoing Costs:

• Hosting: $0-100/month
• Minimal deployment time
• Remote updates (no visits)

Advantages:

• Instant updates
• Remote management
• Central monitoring

---

⚡ Performance Comparison

Android

Metric	Performance
App Startup	Fast (2-3 seconds)
Memory Usage	80-150 MB
CPU Usage	Low (5-10%)
Network	SignalR WebSocket
Rendering	Native Android
Wake Lock	Native, reliable
Audio Latency	Low
Camera Access	Direct, fast

Web (Expected)

Metric	Performance
Page Load	Fast (2-4 seconds first load)
Memory Usage	100-200 MB (browser + app)
CPU Usage	Low-Medium (10-20% with browser)
Network	SignalR WebSocket (same)
Rendering	Chromium rendering engine
Wake Lock	Browser API, reliable on Chrome
Audio Latency	Low-Medium (browser dependent)
Camera Access	WebRTC, slight delay

Overall: Web performance is comparable, with slightly higher memory usage due to browser overhead.

---

🔒 Security Comparison

Android

Pros:

• Full control over device
• Can lock down Android completely
• No browser vulnerabilities
• Native app sandbox

Cons:

• Physical device access required for setup
• APK can be extracted/reverse engineered
• Must manage device security

Web

Pros:

• HTTPS encryption
• Browser security features
• Easy SSL certificate management
• Remote security updates

Cons:

• Browser can be accessed
• JavaScript can be viewed
• Depends on browser security
• Users can close browser (without kiosk mode)

Recommendation:

• Both can be secured adequately
• Web requires HTTPS + browser kiosk mode
• Android requires device lockdown

---

📈 Migration Timeline

Phase	Android (Maintain)	Web (Build)	Total Time
Phase 1: Setup	0 days	1-2 days	1-2 days
Phase 2: Services	0 days	3-5 days	3-5 days
Phase 3: Core Updates	0 days	2-3 days	2-3 days
Phase 4: UI Updates	0 days	2-3 days	2-3 days
Phase 5: Testing	1 day	4-6 days	5-7 days
Phase 6: Deployment	0 days	3-5 days	3-5 days
Phase 7: Kiosk Setup	0 days	2-3 days	2-3 days
Phase 8: Documentation	0 days	1-2 days	1-2 days
TOTAL	1 day	22-31 days	23-32 days

---

🎯 Decision Matrix

Choose Android If:

• ✅ You need complete device control
• ✅ You have IT staff for physical deployment
• ✅ You want true offline operation
• ✅ You need guaranteed 24/7 uptime
• ✅ You don't need frequent updates

Choose Web If:

• ✅ You want instant updates across all locations
• ✅ You want centralized management
• ✅ You have stable HTTPS hosting
• ✅ You want easier deployment
• ✅ You can use browser kiosk mode
• ✅ You want cross-platform support (future: tablets, desktops)

Choose Both If:

• ✅ You want maximum flexibility
• ✅ You can maintain both codebases (with shared business logic)
• ✅ You want to test web in pilot locations first
• ✅ You need backup deployment option

---

📊 Recommendation

For HMG_QLine Project:

Recommended Approach: Gradual Migration

1. Phase 1 (Now): Keep Android as primary
2. Phase 2 (2-4 weeks): Build web version
3. Phase 3 (1 week): Pilot test web in 2-3 locations
4. Phase 4 (2 weeks): Evaluate feedback
5. Phase 5 (Ongoing): Migrate locations gradually

Reasoning:

• ✅ No disruption to current operations
• ✅ Test web thoroughly before full rollout
• ✅ Keep Android as fallback
• ✅ Evaluate real-world performance
• ✅ Easy to roll back if issues arise

---

📞 Quick Reference

Need detailed implementation?
→ See WEB_MIGRATION_GUIDE.md

Need step-by-step checklist?
→ See WEB_MIGRATION_CHECKLIST.md

Need project architecture?
→ See PROJECT_CONTEXT.md

Need recent changes info?
→ See QUICK_SUMMARY.md

---

Last Updated: July 30, 2026
Status: Migration not started (planning phase)