Hotel-Nex

HotelNex is a modern multi-tenant, white-label hotel management and food ordering SaaS platform for Tanzania and beyond, built with Django and React. It enables seamless hotel bookings, food ordering and delivery, reviews, loyalty rewards, and dynamic platform management for guests, hotel admins, and superusers all in one secure, mobile-friendly solution.

HotelNex

A modern, production-ready hotel management and food ordering platform for Tanzania and beyond. Built with Django (backend) and React + TypeScript (frontend).

Features

• Hotel listing, booking, and management
• Food ordering and delivery (per hotel)
• User, hotel admin, and superuser dashboards
• Reviews and ratings (platform, hotel, food)
• Loyalty points and rewards system
• Secure authentication (JWT)
• Notifications and analytics
• Dynamic platform branding and settings
• Mobile-friendly, modern UI

Tech Stack

• Backend: Python, Django, Django REST Framework, PostgreSQL, Celery, Redis
• Frontend: React, TypeScript, Vite, Tailwind CSS
• Other: WebSockets (Django Channels), Sentry, Docker (optional)

Monorepo Structure

smartstay_project/
  ├── smartstay_project/         # Django project (settings, URLs, wsgi/asgi)
  ├── hotels/                   # Hotel models, views, admin
  ├── food_ordering/            # Food ordering models, views
  ├── room_booking/             # Room and booking models, views
  ├── reviews/                  # Review system
  ├── subscriptions/            # Subscription plans
  ├── payments/                 # Payment integration
  ├── notifications/            # Notification system
  ├── platform_management/      # Platform-wide settings
  ├── users/                    # User model and auth
  ├── chatbot/                  # AI chatbot integration
  ├── frontend_project/         # React + TypeScript frontend
  └── ...

Getting Started

Prerequisites

• Python 3.9+
• Node.js 18+
• PostgreSQL (or SQLite for dev)
• Redis (for Celery/Channels)

Backend Setup (Django)

1. Clone the repo:

   git clone <your-repo-url>
   cd smartstay_project

2. Create a virtual environment:

   python3 -m venv .venv
   source .venv/bin/activate

3. Install dependencies:

   pip install -r requirements.txt

4. Configure environment variables:
   • Copy .env.example to .env and fill in your secrets (DB, secret key, etc.)
5. Run migrations:

   python manage.py migrate

6. Create a superuser:

   python manage.py createsuperuser

7. Run the backend server:

   python manage.py runserver

Frontend Setup (React)

1. Install dependencies:

   cd frontend_project
   npm install

2. Configure environment variables:
   • Copy .env.example to .env and set API base URL, etc.
3. Run the frontend dev server:

   npm run dev

Running Celery (for async tasks)

celery -A smartstay_project worker -l info

Running Channels (WebSockets)

python manage.py runworker

Environment Variables

• See .env.example for all required variables (DB, secret key, Sentry, etc.)

Deployment

• Use Gunicorn/Uvicorn for production
• Set DEBUG=False and configure allowed hosts, CORS, and secure settings
• Use a production-ready database (PostgreSQL recommended)
• Set up static/media file serving (e.g., via WhiteNoise, S3, or Nginx)
• Configure Sentry for error monitoring

Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.

1. Fork the repo
2. Create your feature branch (git checkout -b feature/your-feature)
3. Commit your changes (git commit -am 'Add new feature')
4. Push to the branch (git push origin feature/your-feature)
5. Open a pull request