🏨 Reservation System — Inspired by IRTRA Hostels

A full-stack hotel reservation platform inspired by the IRTRA hostels in Guatemala. This is an independent, unofficial project — it adds one feature the real IRTRA site doesn't offer: booking a stay online.

Features

• Browse hotel information — location, amenities, and general details per property
• Make reservations online — a booking flow the official site doesn't support

Tech stack

Frontend: React, Material UI, CSS Backend: Node.js, Express, MySQL

Getting started

Prerequisites

• Node.js
• MySQL server running locally or accessible remotely
• A code editor (VS Code recommended)

Installation

Clone both repositories — the frontend and backend are split into separate projects:

git clone https://github.com/alegudiel/ReservationSystem.git
git clone https://github.com/alegudiel/ReservationSystem-Backend.git

Install dependencies in each:

cd ReservationSystem && npm install
cd ../ReservationSystem-Backend && npm install

Running locally

Start the backend:

cd ReservationSystem-Backend
npm run dev

In a second terminal, start the frontend:

cd ReservationSystem
npm start

Open http://localhost:3000 in your browser.

Project structure

Frontend (ReservationSystem)

src/
├── api/          → API calls to the backend
├── Assets/       → images, icons, static assets
├── Components/   → reusable UI components
├── Containers/   → page-level components
├── Styles/       → CSS
├── UI/           → shared UI primitives
└── Utils/        → helpers

Backend (ReservationSystem-Backend)

src/
├── config/       → environment and app configuration
├── controllers/  → request handlers
├── routes/       → API route definitions
├── scripts/      → setup/utility scripts
└── types/        → TypeScript types

Available scripts

Frontend — npm start runs the app in development mode at localhost:3000, with hot reload and lint errors surfaced in the console.

Backend — npm run dev runs the server with nodemon for live reload.

Status

This was an early full-stack project and isn't under active development. It's kept here as a reference for full-stack fundamentals (auth, REST API design, relational data modeling) from earlier in my path toward HCI and data science.

Acknowledgments

• IRTRA Hostels — for the inspiration
• The open-source tools and libraries this project depends on