# noor-eldin-essam/the-wild-oasis-website-nextjs architecture

> Architecture diagram of the GitHub repository noor-eldin-essam/the-wild-oasis-website-nextjs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-02-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/noor-eldin-essam/the-wild-oasis-website-nextjs
- Repository: https://github.com/noor-eldin-essam/the-wild-oasis-website-nextjs

## Overview

##### High-Level Architecture Components

a) Frontend Layer
- Next.js App Router Architecture
- Client Components
- Server Components
- API Routes

b) Backend Services
- Authentication Service (NextAuth.js)
- Supabase Integration
- Data Service Layer

c) External Services
- Supabase Database
- Authentication Providers

##### Component Organization

A. Client-Side Components (Place at the top):
- Components Layer
- Layout Components (Header, Navigation, SideNavigation)
- Feature Components
- Cabin Related (CabinList, CabinCard, Cabin)
- Reservation Related (ReservationList, ReservationForm)
- User Related (UpdateProfileForm, SignInButton)
- UI Components (Spinner, TextExpander, Price)

B. Application Logic Layer (Place in the middle):
- Pages & Routes
- Dynamic Routes (/cabins/[cabinId])
- Protected Routes (/account/*)
- Public Routes (/, /about, /login)

C. Server-Side Layer (Place at the bottom):
- API Routes
- Authentication Endpoints
- Cabin Management Endpoints
- Data Services
- Supabase Client

##### Important Architectural Patterns to Highlight

- Next.js App Router pattern with nested layouts
- Server Components vs Client Components
- API Routes for external communications
- Middleware for authentication
- Context-based state management (ReservationContext)

##### Technical Stack Indicators

- Next.js
- Supabase
- NextAuth.js
- TailwindCSS

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Client Layer"
        direction TB
        LC["Layout Components"]
        FC["Feature Components"]
        UC["UI Components"]
        
        subgraph "Layout Components"
            direction TB
            HD["Header"]:::component
            NV["Navigation"]:::component
            SN["Side Navigation"]:::component
            RL["Root Layout"]:::component
        end
        
        subgraph "Feature Components"
            direction TB
            
            subgraph "Cabin Components"
                CL["CabinList"]:::component
                CC["CabinCard"]:::component
                CB["Cabin"]:::component
            end
            
            subgraph "Reservation Components"
                RL2["ReservationList"]:::component
                RF["ReservationForm"]:::component
                RC["ReservationCard"]:::component
                RCT["ReservationContext"]:::component
            end
            
            subgraph "User Components"
                UPF["UpdateProfileForm"]:::component
                SIB["SignInButton"]:::component
                SOB["SignOutButton"]:::component
            end
        end
        
        subgraph "UI Components"
            SP["Spinner"]:::component
            SPM["SpinnerMini"]:::component
            TE["TextExpander"]:::component
            PR["Price"]:::component
        end
    end
    
    subgraph "Application Logic Layer"
        direction TB
        subgraph "Routes"
            DR["Dynamic Routes"]
            PR2["Protected Routes"]
            PUR["Public Routes"]
            
            HP["Home Page"]:::component
            AP["About Page"]:::component
            LP["Login Page"]:::component
            CP["Cabin Pages"]:::component
            ACP["Account Pages"]:::component
            RPM["Profile Management"]:::component
            RRM["Reservations Management"]:::component
        end
    end
    
    subgraph "Server Layer"
        direction TB
        subgraph "Backend Services"
            AS["Authentication Service"]:::component
            DSL["Data Service Layer"]:::component
            SI["Supabase Integration"]:::component
            SA["Server Actions"]:::component
        end
        
        subgraph "API Routes"
            AE["Authentication Endpoints"]:::component
            CME["Cabin Management Endpoints"]:::component
        end
    end
    
    subgraph "External Services"
        SDB[(Supabase DB)]
        AP2["Auth Providers"]
    end
    
    %% Connections
    LC --> DR
    FC --> DR
    UC --> FC
    DR --> AS
    PR2 --> AS
    PUR --> DSL
    AS --> AP2
    DSL --> SI
    SI --> SDB
    
    %% Styles
    classDef component fill:#f9f,stroke:#333,stroke-width:2px
    classDef external fill:#ff9,stroke:#333,stroke-width:2px
    
    %% Click Events
    click HD "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/Header.js"
    click NV "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/Navigation.js"
    click SN "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/SideNavigation.js"
    click RL "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/layout.js"
    click CL "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/CabinList.js"
    click CC "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/CabinCard.js"
    click CB "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/Cabin.js"
    click RL2 "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/ReservationList.js"
    click RF "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/ReservationForm.js"
    click RC "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/ReservationCard.js"
    click RCT "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/ReservationContext.js"
    click UPF "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/UpdateProfileForm.js"
    click SIB "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/SignInButton.js"
    click SOB "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/SignOutButton.js"
    click SP "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/Spinner.js"
    click SPM "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/SpinnerMini.js"
    click TE "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/TextExpander.js"
    click PR "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_components/Price.js"
    click AS "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_lib/auth.js"
    click DSL "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_lib/data-service.js"
    click SI "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_lib/supabase.js"
    click SA "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/_lib/actions.js"
    click AE "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/api/auth/[...nextauth]/route.js"
    click CME "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/api/cabins/[cabinId]/route.js"
    click HP "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/page.js"
    click AP "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/about/page.js"
    click LP "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/login/page.js"
    click CP "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/cabins/[cabinId]/page.js"
    click RPM "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/account/profile/page.js"
    click RRM "https://github.com/Noor-Eldin-Essam/the-wild-oasis-website-nextjs/blob/main/app/account/reservations/page.js"
```
