Hospitality · Mobile App
Hotels Guide
A dual-role hotel experience platform that knows your guests and empowers your staff. One mobile app, two distinct user worlds.
Project Overview
Hotels Guide is an end-to-end mobile platform built for hotel chains. Two distinct user roles live inside the same app: guest and staff. Guests sign in via QR code or email and use the restaurant menu, room service, spa and breakfast requests, and rating flows in seconds. Staff sign in with their username to access the app’s management mode — receiving guest emergency alerts, approving or rejecting them, and dispatching them to the team via push notifications.
Traditional hotel apps offer little more than a static information board. Hotels Guide eliminates the gap between guest requests and operations, making the stay experience seamless for both guests and the hospitality team.
Sector
Hospitality
Platform
iOS & Android
Core Stack
Flutter · Firebase
Key Features
👥
Dual-Role Sign-In
Guests log in with email, staff with username — same app, different access levels. The server determines the role automatically.
📱
Multi-Purpose QR Scanner
A single scan jumps from a restaurant table to its menu — or instantly authenticates a guest. Torch and camera-switching included.
🚨
Location-Aware Emergency
Geolocator auto-subscribes to the FCM topic of the nearest hotel within 1 km. Approval/rejection workflow with prioritized notification sound.
🛒
Multi-Currency Cart
Table-bound ordering from the restaurant menu; smart cart engine totals TRY, EUR, USD and other currencies independently.
🛎️
Guest Services
Laundry, room service, breakfast tray, spa booking and wake-up calls — a single front-desk workflow with one-tap requests.
⭐
Smart Rating Flow
High scores route to Google Business reviews; low scores fall into a private feedback form. Two-channel reputation management.
Technical Architecture
- Single Code Base, Two Platforms: Flutter 3.6+ ships iOS and Android together with Material Design 3 and full Turkish (tr_TR) localization.
- Stateful Widgets + SharedPreferences: Persists session, user data and location; a centralized
ApiClientabstracts 15+ REST endpoints in one place. - Firebase Cloud Messaging: Two notification channels (emergency and general); iOS uses time sensitive priority, Android uses a custom sound and vibration profile.
- Geolocator Smart Subscriptions: The splash screen calculates the nearest hotel; FCM topic subscriptions for hotels beyond 1 km are removed automatically.
- Multi-Format QR Parsing: The same scanner opens menus, fetches sign-in credentials or surfaces a clear error message — depending on the payload format.
- HTML Content Rendering:
flutter_htmlrenders rich-text hotel descriptions natively from server-side content. - Crashlytics & Zone Guard: All runtime errors in production are captured; debug builds simply log to the console.
Tech Stack
Flutter 3.6 · Dart · Firebase Cloud Messaging · Firebase Crashlytics · mobile_scanner · Geolocator · flutter_local_notifications · flutter_html · awesome_dialog · toastification · SharedPreferences · REST API
By the Numbers
20+
Independent screens & modules
15+
REST API integrations
2
Platforms · iOS & Android
2
User roles in one app