How jancarliux24/hotel-lumbre works
Lumbre is a cross-platform hotel guest and operations app, with a separate static JavaScript hotel website also documented in the repository. The KMP user journey enters through a platform host, reaches shared navigation and guest screens, then uses booking rules and the repository for reservation/account operations; staff and superuser screens provide distinct operational branches. Firebase-backed persistence and location-based locale selection are meaningful integrations. README capability claims guide unsampled feature nodes; their internal connections are omitted where source excerpts do not establish them.
Main entry points: App.kt Shared app and navigation · HotelRepository.kt Hotel repository · BookingScreen.kt Booking flow · Catalog.kt Hotel catalog data
Components 29
App entry
- Android host
app/androidApp/src/main/kotlin/com/lumbre/hotel/MainActivity.kt - iOS host
app/shared/src/iosMain/kotlin/com/lumbre/hotel/MainViewController.kt - Web host
app/webApp/src/wasmJsMain/kotlin/com/lumbre/hotel/main.kt - Shared app and navigation
app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt
Guest experience
- Home and discovery
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/HomeScreen.kt - Room catalog
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/RoomsScreen.kt - Room details
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/RoomDetailScreen.kt - Offers
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/OffersScreen.kt - Booking flow
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/BookingScreen.kt - Trips
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/TripsScreen.kt - Profile and account
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/ProfileScreen.kt - Privacy preferences
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/PrivacyScreen.kt - Digital key
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/KeyScreen.kt
Hotel operations
- Admin panel
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/AdminScreen.kt - Reception desk
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/ReceptionScreen.kt - Superuser panel
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/SuperAdminScreen.kt
Shared services
- Hotel repository
app/shared/src/commonMain/kotlin/com/lumbre/hotel/data/HotelRepository.kt - Pricing rules
app/shared/src/commonMain/kotlin/com/lumbre/hotel/domain/Pricing.kt - Input validation
app/shared/src/commonMain/kotlin/com/lumbre/hotel/domain/Validation.kt - Currency and dates
app/shared/src/commonMain/kotlin/com/lumbre/hotel/domain/Format.kt - Hotel catalog data
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/components/Catalog.kt - Translations
app/shared/src/commonMain/kotlin/com/lumbre/hotel/i18n/Strings.kt - Lumi mascot
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/components/Lumi.kt
External services
- Firebase APIs
app/shared/src/commonMain/kotlin/com/lumbre/hotel/data/firebase/FirebaseApi.kt - Cloud data
- Location lookup
app/shared/src/commonMain/kotlin/com/lumbre/hotel/platform/Location.kt - Reverse geocoder
Other components
- Guest
- Static hotel website
js/app.js
Connections 37
- Guest → Android host: opens
- Guest → iOS host: opens
- Guest → Web host: opens
- Android host → Shared app and navigation: launches
app/androidApp/src/main/kotlin/com/lumbre/hotel/MainActivity.kt - iOS host → Shared app and navigation: embeds
app/shared/src/iosMain/kotlin/com/lumbre/hotel/MainViewController.kt - Web host → Shared app and navigation: launches
app/webApp/src/wasmJsMain/kotlin/com/lumbre/hotel/main.kt - Shared app and navigation → Home and discovery: routes to
app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt - Shared app and navigation → Room catalog: routes to
app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt - Shared app and navigation → Room details: routes to
app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt - Shared app and navigation → Offers: routes to
app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt - Shared app and navigation → Booking flow: routes to
app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt - Shared app and navigation → Trips: routes to
app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt - Shared app and navigation → Profile and account: routes to
app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt - Shared app and navigation → Privacy preferences: routes to
app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt - Shared app and navigation → Digital key: routes to
app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt - Shared app and navigation → Admin panel: routes to
app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt - Shared app and navigation → Reception desk: routes to
app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt - Shared app and navigation → Superuser panel: routes to
app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt - Booking flow → Pricing rules: calculates quote
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/BookingScreen.kt - Booking flow → Input validation: validates input
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/BookingScreen.kt - Booking flow → Hotel repository: reads promos
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/BookingScreen.kt - Booking flow → Hotel repository: records booking
- Hotel repository → Firebase APIs: calls APIs
app/shared/src/commonMain/kotlin/com/lumbre/hotel/data/HotelRepository.kt - Firebase APIs → Cloud data: reads and writes
- Hotel repository → Currency and dates: uses formatting
- Home and discovery → Hotel catalog data: reads catalog
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/HomeScreen.kt - Room catalog → Hotel catalog data: reads catalog
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/RoomsScreen.kt - Room details → Hotel catalog data: reads catalog
app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/RoomDetailScreen.kt - Trips → Hotel repository: reads reservations
- Profile and account → Hotel repository: manages account
- Admin panel → Hotel repository: manages hotel data
- Reception desk → Hotel repository: reads arrivals
- Superuser panel → Hotel repository: manages roles
- Shared app and navigation → Translations: uses translations
app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt - Shared app and navigation → Lumi mascot: renders mascot
app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt - Location lookup → Reverse geocoder: queries country
app/shared/src/commonMain/kotlin/com/lumbre/hotel/platform/Location.kt - Guest → Static hotel website: visits