🏨 Hotel Mess Manager

A mobile-first application designed to simplify meal subscription management for hotels, hostels, and mess facilities. Track clients, manage subscriptions, monitor payments, and stay on top of your business—all in one place.

✨ Features

• Client Management – Add, edit, and manage client profiles with contact information
• Meal Subscriptions – Create and manage date-based subscription plans
• Payment Tracking – Monitor paid and pending balances at a glance
• Live Dashboard – Real-time metrics including active subscriptions, revenue, and payment status
• Smart Search – Quickly find clients by name/phone and subscriptions by client name
• Status Filtering – Filter subscriptions by all, active, or expired status
• Offline-First – All data stored locally on your device—no internet required

🚀 Quick Start

Prerequisites

• Node.js (v18 or higher)
• npm or yarn
• Android/iOS device or emulator

Installation

1. Clone the repository

   git clone https://github.com/saranzafar/hotel-book.git
   cd hotel-book

2. Install dependencies

   npm install

3. Start the development server

   npx expo start

4. Open on your device

   • Scan the QR code with Expo Go app (iOS/Android)
   • Or press a for Android emulator or i for iOS simulator

📱 App Structure

hotel-book/
├── app/
│   ├── (tabs)/
│   │   ├── _layout.tsx         # Tab navigation
│   │   ├── index.tsx           # Home dashboard
│   │   ├── clients.tsx         # Client management
│   │   ├── mess.tsx            # Subscription management
│   │   └── about.tsx           # About screen
│   ├── components/
│   │   ├── AddClientDrawer.tsx
│   │   ├── EditClientDrawer.tsx
│   │   ├── AddSubscriptionDrawer.tsx
│   │   ├── EditSubscriptionDrawer.tsx
│   │   └── dashboard/
│   └── _layout.tsx             # App initialization
├── src/
│   └── database/
│       ├── db.js               # SQLite setup
│       └── queries.js          # Database operations
└── package.json

🎯 How to Use

Managing Clients

1. Add a Client

   • Go to the Clients tab
   • Tap the + button
   • Fill in name (required) and phone number (required)
   • Optional: Add email, address, and notes
   • Tap "Add Client"

2. Edit a Client

   • Tap any client card
   • Update information as needed
   • Tap "Save" to confirm

3. Delete a Client

   • Tap any client card
   • Tap the "Delete" button
   • Confirm the action

Managing Subscriptions

1. Add a Subscription

   • Go to the Mess tab
   • Tap the + button
   • Select a client from the dropdown
   • Choose start and end dates (automatic day count calculation)
   • Enter total amount and amount paid
   • Tap "Add Subscription"

2. Edit a Subscription

   • Tap any subscription card
   • Modify dates, amounts, or active status
   • Tap "Save" to confirm

3. Delete a Subscription

   • Tap any subscription card
   • Tap the "Delete" button
   • Confirm the action

Viewing the Dashboard

• Home tab shows key metrics:
  • Active subscriptions count
  • Total revenue collected
  • Pending payment counts
  • Subscriptions expiring in the next 7 days

🛠️ Technology Stack

💾 Database Schema

Tables

• clients – Store client information (name, phone, email, address)
• mess_subscriptions – Track meal subscriptions (dates, amounts, status)
• payments – Record payment history

Data is stored locally in SQLite on your device.

🔒 Privacy & Security

• 100% Offline – No internet connection needed after installation
• Local Storage – All data remains on your device
• No Built-in Encryption – Database encryption is not currently enabled
• No Cloud Sync – Your information stays private and secure
• No Ads or Tracking – Clean, distraction-free experience

🐛 Troubleshooting

App won't start?

# Clear cache and reinstall
npm install
npx expo start -c

Date picker not showing?

• Ensure @react-native-community/datetimepicker is installed
• Run npx expo install @react-native-community/datetimepicker

Database errors?

• Clear Expo cache: npx expo start --clear
• Uninstall and reinstall the app on your device

📝 License

This project is open-source and available under the MIT License.

💬 Support

Found a bug or have a suggestion? Feel free to open an issue or reach out.

• Developer: Saran Zafar
• Email: saran.development@example.com
• Phone: +91 XXXXX XXXXX

🙏 Acknowledgments

Built with ❤️ using React Native and Expo to make hotel and mess management simpler, faster, and more efficient.

Last Updated: Feb 2026
Version: 2.0.0