https://github.com/basmasalim/the-wild-oasis

Hotel management app - full-featured Angular web application that allows hotel employees to manage cabins, bookings, and guests.
https://github.com/basmasalim/the-wild-oasis

angular20 dashboard primeng-v20 scss theme-switcher

Last synced: about 2 months ago
JSON representation

Hotel management app - full-featured Angular web application that allows hotel employees to manage cabins, bookings, and guests.

• Host: GitHub
• URL: https://github.com/basmasalim/the-wild-oasis
• Owner: basmasalim
• Created: 2025-08-05T03:06:29.000Z (11 months ago)
• Default Branch: master
• Last Pushed: 2025-08-13T15:13:13.000Z (10 months ago)
• Last Synced: 2025-08-13T15:20:56.897Z (10 months ago)
• Topics: angular20, dashboard, primeng-v20, scss, theme-switcher
• Language: TypeScript
• Homepage: https://the-wild-oasis-jade-three.vercel.app
• Size: 408 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          


  
The Wild Oasis 


  


    

      Live Site

    

  






Welcome to The Wild Oasis! This is a hotel management admin web app where employees can manage cabins, bookings, and guests.  

It is built with Angular 20 using SSR, zoneless rendering, and PrimeNG for UI, with Firebase as backend for authentication and real-time data.





![Screenshot](./public/thumbnail-preview.jpg)



---

## ✨ Key Features

- User authentication via Firebase  

- Dashboard with stats on bookings, check-ins, and revenue  

- Manage cabins (create, update, delete)  

- Manage guests and bookings (check-in, check-out, update status)  

- Real-time data synchronization using Firebase  

- Responsive UI built with PrimeNG  

- Dark mode support  

- Optimized performance with Angular SSR and Zoneless rendering  

---

## 🛠️ Technologies Used

- **Angular 20** with **Server-Side Rendering (SSR)**  

- **PrimeNG** for modern, responsive UI components  

- **Zoneless Angular** (using Signals for reactivity)  

- **Firebase** (Authentication, Firestore, Real-time Database)  

- **TypeScript**  

- **SCSS**  

---

## 📚 What I Learned

This project helped me deepen my skills in:  

- **SSR in Angular** for performance & SEO  

- **Zoneless Angular** with Signals for fine-grained reactivity  

- **PrimeNG** to build production-ready UIs quickly  

- **Real-time applications** using Firebase  

- **Scalable architecture** for admin dashboards  

---

## ⚡ Setup Instructions

To run this project locally:

1. Clone the repo:

   ```bash

   git clone https://github.com/basmasalim/The-Wild-Oasis.git

   cd The-Wild-Oasis

2. Install dependencies:

   ```bash

   npm install

   ```

3. Setup environment variables:

   * Add Firebase keys in `src/environments/environment.ts`

4. Run the development server:

   ```bash

   ng serve

   ```

5. Open `http://localhost:4200` in your browser.

## 🙏 Acknowledgments

Special thanks to the Angular and Firebase communities for their amazing documentation and tools.