# youesf-gif/the-wild-oasis architecture

> Architecture diagram of the GitHub repository youesf-gif/the-wild-oasis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/youesf-gif/the-wild-oasis
- Repository: https://github.com/youesf-gif/the-wild-oasis

## Overview

The Wild Oasis is a React hotel-operations application built with React Query and Supabase. Hotel staff enter through the protected application or login page, then manage bookings and cabins, process check-ins, review dashboard activity, and update settings or account data. The graph follows documented routing and sampled data hooks into Supabase-backed services. Several feature implementations were not sampled, so their domain branches are represented at their existing directories; their internal call paths are not inferred.

Main entry points: [`src/App.jsx`](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/App.jsx) (App router), [`src/services/apiBookings.js`](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/services/apiBookings.js) (Booking data service), [`src/services/supabase.js`](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/services/supabase.js) (Supabase), [`src/features/authentication`](https://github.com/youesf-gif/the-wild-oasis/tree/main/src/features/authentication) (Authentication forms)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_app["App router<br/>[App.jsx]"]
  node_layout["App layout<br/>[AppLayout.jsx]"]
  node_darkmode["Dark mode"]
end

subgraph group_identity["Identity"]
  node_loginpage["Login page<br/>[Login.jsx]"]
  node_authfeatures["Authentication forms"]
  node_authapi["Authentication service<br/>[apiAuth.js]"]
  node_accountpage["Account page<br/>[Account.jsx]"]
end

subgraph group_operations["Hotel Operations"]
  node_bookingspage["Bookings page<br/>[Bookings.jsx]"]
  node_bookingfeatures["Booking management"]
  node_bookingdetail["Booking detail<br/>[BookingDetail.jsx]"]
  node_checkinpage["Check-in page<br/>[Checkin.jsx]"]
  node_checkinfeatures["Check-in and checkout"]
  node_cabinpage["Cabins page<br/>[Cabins.jsx]"]
  node_cabinfeatures["Cabin management"]
  node_settingspage["Settings page<br/>[Settings.jsx]"]
  node_settingsfeatures["Settings management"]
end

subgraph group_insights["Dashboard"]
  node_dashboardpage["Dashboard page<br/>[Dashboard.jsx]"]
  node_dashboardfeatures["Dashboard analytics"]
end

subgraph group_platform["Data Platform"]
  node_bookingapi["Booking data service<br/>[apiBookings.js]"]
  node_cabinapi["Cabin data service<br/>[apiCabins.js]"]
  node_settingsapi["Settings data service<br/>[apiSettings.js]"]
  node_supabase[("Supabase<br/>[supabase.js]")]
end

node_staff(("Hotel staff"))

node_staff -->|"opens"| node_app
node_app -->|"routes through"| node_layout
node_app -->|"routes to"| node_loginpage
node_app -->|"routes to"| node_bookingspage
node_app -->|"routes to"| node_bookingdetail
node_app -->|"routes to"| node_checkinpage
node_app -->|"routes to"| node_cabinpage
node_app -->|"routes to"| node_settingspage
node_app -->|"routes to"| node_accountpage
node_app -->|"routes to"| node_dashboardpage
node_app -->|"provides"| node_darkmode
node_loginpage -->|"renders"| node_authfeatures
node_accountpage -->|"renders"| node_authfeatures
node_bookingspage -->|"renders"| node_bookingfeatures
node_bookingdetail -.->|"uses"| node_bookingfeatures
node_checkinpage -->|"renders"| node_checkinfeatures
node_cabinpage -->|"renders"| node_cabinfeatures
node_settingspage -->|"renders"| node_settingsfeatures
node_dashboardpage -->|"renders"| node_dashboardfeatures
node_authfeatures -->|"uses"| node_authapi
node_bookingfeatures -->|"queries and updates"| node_bookingapi
node_checkinfeatures -->|"updates bookings"| node_bookingapi
node_dashboardfeatures -->|"loads activity"| node_bookingapi
node_cabinfeatures -->|"uses"| node_cabinapi
node_settingsfeatures -->|"uses"| node_settingsapi
node_authapi -->|"authenticates through"| node_supabase
node_bookingapi -->|"reads and writes"| node_supabase
node_cabinapi -->|"uses"| node_supabase
node_settingsapi -->|"uses"| node_supabase

click node_app "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/App.jsx"
click node_layout "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/ui/AppLayout.jsx"
click node_darkmode "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/context/DarkModeContext.jsx"
click node_loginpage "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/pages/Login.jsx"
click node_authfeatures "https://github.com/youesf-gif/the-wild-oasis/tree/main/src/features/authentication"
click node_authapi "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/services/apiAuth.js"
click node_bookingspage "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/pages/Bookings.jsx"
click node_bookingfeatures "https://github.com/youesf-gif/the-wild-oasis/tree/main/src/features/bookings"
click node_bookingdetail "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/features/bookings/BookingDetail.jsx"
click node_checkinpage "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/pages/Checkin.jsx"
click node_checkinfeatures "https://github.com/youesf-gif/the-wild-oasis/tree/main/src/features/check-in-out"
click node_cabinpage "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/pages/Cabins.jsx"
click node_cabinfeatures "https://github.com/youesf-gif/the-wild-oasis/tree/main/src/features/cabins"
click node_settingspage "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/pages/Settings.jsx"
click node_settingsfeatures "https://github.com/youesf-gif/the-wild-oasis/tree/main/src/features/settings"
click node_accountpage "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/pages/Account.jsx"
click node_dashboardpage "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/pages/Dashboard.jsx"
click node_dashboardfeatures "https://github.com/youesf-gif/the-wild-oasis/tree/main/src/features/dashboard"
click node_bookingapi "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/services/apiBookings.js"
click node_cabinapi "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/services/apiCabins.js"
click node_settingsapi "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/services/apiSettings.js"
click node_supabase "https://github.com/youesf-gif/the-wild-oasis/blob/main/src/services/supabase.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_layout,node_darkmode toneBlue
class node_loginpage,node_authfeatures,node_authapi,node_accountpage toneAmber
class node_bookingspage,node_bookingfeatures,node_bookingdetail,node_checkinpage,node_checkinfeatures,node_cabinpage,node_cabinfeatures,node_settingspage,node_settingsfeatures toneMint
class node_dashboardpage,node_dashboardfeatures toneRose
class node_bookingapi,node_cabinapi,node_settingsapi,node_supabase,node_staff toneIndigo
```

## Components

### Application

- [App router](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/App.jsx): `src/App.jsx`
- [App layout](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/ui/AppLayout.jsx): `src/ui/AppLayout.jsx`
- [Dark mode](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/context/DarkModeContext.jsx): `src/context/DarkModeContext.jsx`

### Identity

- [Login page](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/pages/Login.jsx): `src/pages/Login.jsx`
- [Authentication forms](https://github.com/youesf-gif/the-wild-oasis/tree/main/src/features/authentication): `src/features/authentication`
- [Authentication service](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/services/apiAuth.js): `src/services/apiAuth.js`
- [Account page](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/pages/Account.jsx): `src/pages/Account.jsx`

### Hotel Operations

- [Bookings page](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/pages/Bookings.jsx): `src/pages/Bookings.jsx`
- [Booking management](https://github.com/youesf-gif/the-wild-oasis/tree/main/src/features/bookings): `src/features/bookings`
- [Booking detail](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/features/bookings/BookingDetail.jsx): `src/features/bookings/BookingDetail.jsx`
- [Check-in page](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/pages/Checkin.jsx): `src/pages/Checkin.jsx`
- [Check-in and checkout](https://github.com/youesf-gif/the-wild-oasis/tree/main/src/features/check-in-out): `src/features/check-in-out`
- [Cabins page](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/pages/Cabins.jsx): `src/pages/Cabins.jsx`
- [Cabin management](https://github.com/youesf-gif/the-wild-oasis/tree/main/src/features/cabins): `src/features/cabins`
- [Settings page](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/pages/Settings.jsx): `src/pages/Settings.jsx`
- [Settings management](https://github.com/youesf-gif/the-wild-oasis/tree/main/src/features/settings): `src/features/settings`

### Dashboard

- [Dashboard page](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/pages/Dashboard.jsx): `src/pages/Dashboard.jsx`
- [Dashboard analytics](https://github.com/youesf-gif/the-wild-oasis/tree/main/src/features/dashboard): `src/features/dashboard`

### Data Platform

- [Booking data service](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/services/apiBookings.js): `src/services/apiBookings.js`
- [Cabin data service](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/services/apiCabins.js): `src/services/apiCabins.js`
- [Settings data service](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/services/apiSettings.js): `src/services/apiSettings.js`
- [Supabase](https://github.com/youesf-gif/the-wild-oasis/blob/main/src/services/supabase.js): `src/services/supabase.js`

### Other components

- **Hotel staff**

## Connections

- Hotel staff → App router: opens
- App router → App layout: routes through (evidence: `src/App.jsx`)
- App router → Login page: routes to (evidence: `src/App.jsx`)
- App router → Bookings page: routes to (evidence: `src/App.jsx`)
- App router → Booking detail: routes to (evidence: `src/App.jsx`)
- App router → Check-in page: routes to (evidence: `src/App.jsx`)
- App router → Cabins page: routes to (evidence: `src/App.jsx`)
- App router → Settings page: routes to (evidence: `src/App.jsx`)
- App router → Account page: routes to (evidence: `src/App.jsx`)
- App router → Dashboard page: routes to (evidence: `src/App.jsx`)
- App router → Dark mode: provides (evidence: `src/App.jsx`)
- Login page → Authentication forms: renders (evidence: `src/pages/Login.jsx`)
- Account page → Authentication forms: renders (evidence: `src/pages/Account.jsx`)
- Bookings page → Booking management: renders (evidence: `src/pages/Bookings.jsx`)
- Booking detail → Booking management: uses
- Check-in page → Check-in and checkout: renders (evidence: `src/pages/Checkin.jsx`)
- Cabins page → Cabin management: renders (evidence: `src/pages/Cabins.jsx`)
- Settings page → Settings management: renders (evidence: `src/pages/Settings.jsx`)
- Dashboard page → Dashboard analytics: renders (evidence: `src/pages/Dashboard.jsx`)
- Authentication forms → Authentication service: uses (evidence: `src/features/authentication/useLogin.js`)
- Booking management → Booking data service: queries and updates (evidence: `src/features/bookings/useBookings.js`)
- Check-in and checkout → Booking data service: updates bookings (evidence: `src/features/check-in-out/useCheckin.js`)
- Dashboard analytics → Booking data service: loads activity (evidence: `src/features/dashboard/useRecentBookings.js`)
- Cabin management → Cabin data service: uses (evidence: `src/features/cabins/useEditCabin.js`)
- Settings management → Settings data service: uses (evidence: `src/features/settings/useUpdateSetting.js`)
- Authentication service → Supabase: authenticates through (evidence: `src/services/apiAuth.js`)
- Booking data service → Supabase: reads and writes (evidence: `src/services/apiBookings.js`)
- Cabin data service → Supabase: uses (evidence: `src/services/apiCabins.js`)
- Settings data service → Supabase: uses (evidence: `src/services/apiSettings.js`)
