Otelis

A desktop hotel management application built with Electron and React.

Features

• Dashboard — Overview of room occupancy and active reservations
• Room Management — Add, edit, and manage rooms with various types and pricing
• Reservation Management — Create, update, and track reservations with a multi-step wizard
• Customer Management — Keep records of guests and their stay history
• Calendar View — Monthly and room-based calendar for visual occupancy tracking
• Tariff & Pricing — Define seasonal tariffs and room-specific pricing
• Statistics — Revenue breakdowns, occupancy rates, and booking trends
• Database Backup & Restore — Built-in backup management for data safety

Screenshots

Home Dashboard	Room Management

Reservations	Reservation Details

Calendar View	Customer Management

Calendar (Alternate View)

Tech Stack

Layer	Technology
Desktop Shell	Electron
Frontend	React, Material UI, React-Bootstrap
Backend	Express.js
Database	SQLite (better-sqlite3)
Charts	Recharts
Packaging	Electron Builder

Getting Started

Prerequisites

• Node.js 18+
• npm

Installation

git clone https://github.com/yourusername/otelis-app.git
cd otelis-app
npm install

Development

Start the application in development mode:

npm run electron:dev

Build

Package the application for distribution:

macOS:

npm run electron:build:mac

Windows:

npm run electron:build:win

Database Setup

Create and seed the database:

npm run createdb
npm run seed

Project Structure

otelis-app/
├── electron/           # Electron main process
├── public/             # Static assets
├── src/                # React frontend
│   ├── components/     # Reusable components
│   ├── pages/          # Page components
│   └── utils/          # Utilities (API client, database, logger, formatting)
├── data/               # JSON configuration files
├── images/             # Screenshots
├── server.cjs          # Express API server
└── create_database.cjs # Database schema

License

MIT License

Copyright (c) 2025

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.