Resortify-SL

⚠️ IMPORTANT SECURITY NOTE: This project contains hardcoded API keys and secrets. It is intended for educational and demonstrative purposes only. DO NOT DEPLOY THIS CODE TO PRODUCTION. Please replace all sensitive values (API keys, tokens, etc.) with secure environment variables before any real-world usage.

🏝️ A premium, decoupled Hotel Management System tailored for Sri Lankan beach resorts and tourist hotspot hotels. Engineered with a Node.js/Express API and a modern React + Tailwind CSS dashboard featuring dual-currency sync (LKR/USD), real-time KOT tracking with local food modifiers, and local tax compliance (VAT/SSCL).

Features

• Dashboard: Overview of bookings, revenue, and room status.
• Booking Engine: Front-end booking interface with a React Calendar.
• Room Management:CRUD operations for rooms.
• POS System: Point of Sale interface for hotel staff.
• Kitchen Display System: Real-time order tracking (KOT).
• Guest Management: Manage guest information.
• Reports: Generate financial and occupancy reports.
• Food & Beverage: Full menu management with Sri Lankan food modifiers (e.g., "No Spice", "Extra Chili").
• Tax Engine: Automatic VAT and SSCL calculation based on Sri Lankan regulations.
• Currency Sync: Real-time dual-currency display (LKR/USD).

Tech Stack

Frontend

• Framework: React
• Styling: Tailwind CSS
• Icons: Lucide React
• Calendar: React Big Calendar
• Animations: Framer Motion
• State Management: React Hooks

Backend

• Runtime: Node.js
• Framework: Express.js
• Database: MongoDB
• Authentication: JWT
• Utilities: Axios (HTTP client), bcrypt (password hashing)

Setup

Prerequisites

• Node.js (v16 or higher)
• MongoDB

Installation

1. Clone the repository

   git clone <repository-url>
   cd Resortify-hms

2. Backend Setup

   cd backend
   npm install
   # Create a .env file in backend/ directory and add your MongoDB URI
   # Example .env:
   # MONGODB_URI=mongodb+srv://<username>:<password>@<cluster-url>/resortifydb
   # JWT_SECRET=your_secret_key
   # PORT=5000
   
   npm start

3. Frontend Setup

   cd frontend
   npm install
   
   # Update the API URL in src/services/api.js if your backend is running on a different port
   # Example: const API_URL = 'http://localhost:5000';
   
   npm run dev

4. Access the App Open http://localhost:5173 in your browser.

License

ISC

Acknowledgment