🏨 LodgeFlow – Hotel Management System

A modern hotel management dashboard built with Next.js 15, HeroUI, and MongoDB. Features comprehensive cabin management, booking system, customer profiles, and business analytics.

---

✨ Features

• 📊 Dashboard: Real-time statistics, revenue charts, occupancy rates
• 🏠 Cabin Management: CRUD operations, filtering, capacity management
• 📅 Booking System: Reservation management, status tracking, payment processing
• 👥 Customer Profiles: Guest information, booking history, preferences
• ⚙️ Settings: Business rules, pricing, policies configuration
• 🌙 Dark Mode: Full theme support with smooth transitions
• 📱 Mobile Responsive: Optimized for all device sizes

🛠 Tech Stack

• Frontend: Next.js 15 • HeroUI v2 • Tailwind CSS
• Backend: MongoDB • Mongoose ODM
• Tools: TypeScript • SWR • Recharts

🚀 Quick Start

Prerequisites

• Node.js 18+ and pnpm
• MongoDB (Atlas or local installation)

Installation

# Clone the repository
git clone https://github.com/Amadou-dot/LodgeFlow_admin.git
cd LodgeFlow_admin

# Install dependencies
pnpm install

Database Setup

MongoDB Atlas (Recommended)

1. Create a free account at MongoDB Atlas
2. Create a cluster and get your connection string
3. Add to .env.local:

MONGODB_URI=mongodb+srv://username:password@cluster.xxxxx.mongodb.net/lodgeflow
SEED_SECRET=replace-with-a-long-random-secret

SEED_SECRET is required for /api/cron/seed. Call the route with Authorization: Bearer <SEED_SECRET>.

Local MongoDB

1. Install MongoDB Community Server
2. Start the MongoDB service
3. Use the default local configuration

Initialize & Run

# Test database connection
pnpm tsx scripts/test-connection.ts

# Seed with sample data
pnpm seed

# Start development server
pnpm dev

Open http://localhost:3000 to view the dashboard.

📁 Project Structure

app/
├── (auth)/           # Auth-protected routes
├── (dashboard)/      # Main dashboard routes
├── api/             # API routes
└── layout.tsx       # Root layout

components/          # Reusable UI components
hooks/              # Custom React hooks
models/             # MongoDB schemas
types/              # TypeScript definitions
lib/                # Utilities & configurations

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License.

---

Made by Amadou