Maa Laxmi Hotel PMS

Maa Laxmi Hotel PMS (Property Management System)

A premium, neomorphic, real-time hotel management application (PMS) and client storefront built with Flutter and Firebase. This project is fully structured for White-Labeled distribution, enabling it to be packaged, configured, and sold to multiple hotel businesses easily.

Features

White-Label Distribution

• Compile-Time Customization: Static configuration for brand details (hotel name, tagline, address), theme colors, billing defaults, and UPI details.
• Runtime Customization: Operational parameters like check-in/check-out boundaries, GST thresholds, and active UPI accounts can be updated directly through the Storefront Profile Editor without rebuilding the app.

Core Architecture

• Framework: Built primarily with Flutter for cross-platform compatibility (Web & Mobile).
• Backend & Database: Powered by Firebase Firestore, leveraging offline caching and real-time snapshots.
• State Management: Uses the provider pattern to supply dynamic streams of HotelProfile and authentication states.
• Routing: Deep linking implemented via go_router for seamless navigation across check-in portals and public storefronts.
• UI/UX: Features a premium neomorphic theme with both dark and light modes, along with interactive charts (fl_chart) and QR code generation (qr_flutter).

Automation Utility

Includes a Python utility script (white_label_helper.py) designed to automate project setup and management:

• Codebase Audits: Scans the codebase to ensure no leftover hardcoded client details remain.
• Data Clean-up: Safely wipes transient logs, generated spreadsheets, and local database snapshots of previous business transactions before client handover.
• Setup Checklist: Provides a terminal-based step-by-step checklist summarizing deployment instructions.

Technical Stack

• Frontend: Flutter, Dart
• Backend: Firebase (Firestore, Auth, Storage, Cloud Functions, Messaging)
• Scripting & Automation: Python
• Key Packages: Provider, Go Router, FL Chart, QR Flutter, Shimmer, Google Sign-In

Impact & Use Case

This PMS provides a comprehensive solution for hotel owners to manage daily operations, track billing, and provide a digital storefront for guests. The white-label readiness ensures that the software can be rapidly deployed for new clients with minimal manual refactoring, creating a scalable product architecture.