# shiran009/travel-web architecture

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

- Interactive diagram: https://gitdiagram.com/shiran009/travel-web
- Repository: https://github.com/shiran009/travel-web

## Overview

Voyageur is a client-side travel discovery and trip-planning interface. Visitors search curated destinations, inspect trip details, create bookings or custom itineraries, then review and manage reservations; the app also presents flights, stays, travel essentials, wishlists, and reviews. The sampled sources show local UI state and browser storage rather than a backend or external booking service. The graph follows the app’s documented imports and sampled component behavior; some component wiring is supported by the SOURCE INDEX rather than complete source excerpts.

Main entry points: [`src/App.tsx`](https://github.com/shiran009/travel-web/blob/main/src/App.tsx) (App State & Routing), [`src/utils/formatters.ts`](https://github.com/shiran009/travel-web/blob/main/src/utils/formatters.ts) (Pricing & Date Helpers), [`src/data/travelData.ts`](https://github.com/shiran009/travel-web/blob/main/src/data/travelData.ts) (Travel Reference Data), [`src/types/travel.ts`](https://github.com/shiran009/travel-web/blob/main/src/types/travel.ts) (Travel Types)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Shell"]
  node_app["App State &amp; Routing<br/>[App.tsx]"]
  node_models["Travel Types<br/>[travel.ts]"]
  node_formatters["Pricing &amp; Date Helpers<br/>[formatters.ts]"]
  node_toast["Toast Notifications<br/>[Toast.tsx]"]
end

subgraph group_discovery["Travel Discovery"]
  node_navbar["Navigation &amp; Currency<br/>[Navbar.tsx]"]
  node_hero["Search Controls<br/>[HeroSearch.tsx]"]
  node_grid["Destination Results"]
  node_card["Destination Card"]
  node_detail["Destination Details"]
end

subgraph group_planning["Trip Planning"]
  node_booking["Booking Flow<br/>[BookingModal.tsx]"]
  node_bookings["Booking Management"]
  node_itinerary["Custom Itinerary"]
  node_stays["Stays &amp; Flights"]
  node_essentials["Travel Essentials"]
  node_wishlist["Wishlist<br/>[WishlistModal.tsx]"]
end

subgraph group_content["Travel Content"]
  node_destinations["Curated Destinations<br/>[destinations.ts]"]
  node_traveldata["Travel Reference Data<br/>[travelData.ts]"]
  node_reviews["Traveler Reviews<br/>[ReviewsSection.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
end

node_traveler(("Traveler"))

node_traveler -->|"uses"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_hero
node_app -->|"renders"| node_grid
node_app -->|"renders"| node_detail
node_app -->|"renders"| node_booking
node_app -->|"renders"| node_bookings
node_app -->|"renders"| node_itinerary
node_app -->|"renders"| node_stays
node_app -->|"renders"| node_essentials
node_app -->|"renders"| node_wishlist
node_app -->|"renders"| node_reviews
node_app -->|"renders"| node_footer
node_app -->|"renders"| node_toast
node_app -->|"loads data"| node_destinations
node_app -->|"loads data"| node_traveldata
node_app -->|"uses types"| node_models
node_app -->|"uses helpers"| node_formatters
node_grid -->|"renders"| node_card
node_card -->|"formats prices"| node_formatters
node_detail -->|"formats prices"| node_formatters
node_booking -->|"formats booking"| node_formatters
node_booking -->|"reads add-ons"| node_destinations
node_bookings -->|"formats dates"| node_formatters
node_itinerary -->|"loads activities"| node_traveldata
node_itinerary -->|"formats plan"| node_formatters
node_stays -->|"loads options"| node_traveldata
node_essentials -->|"loads guidance"| node_traveldata
node_reviews -->|"uses review type"| node_models
node_destinations -->|"uses types"| node_models
node_traveldata -->|"uses types"| node_models

click node_app "https://github.com/shiran009/travel-web/blob/main/src/App.tsx"
click node_models "https://github.com/shiran009/travel-web/blob/main/src/types/travel.ts"
click node_formatters "https://github.com/shiran009/travel-web/blob/main/src/utils/formatters.ts"
click node_navbar "https://github.com/shiran009/travel-web/blob/main/src/components/Navbar.tsx"
click node_hero "https://github.com/shiran009/travel-web/blob/main/src/components/HeroSearch.tsx"
click node_grid "https://github.com/shiran009/travel-web/blob/main/src/components/DestinationsGrid.tsx"
click node_card "https://github.com/shiran009/travel-web/blob/main/src/components/DestinationCard.tsx"
click node_detail "https://github.com/shiran009/travel-web/blob/main/src/components/DestinationDetailModal.tsx"
click node_booking "https://github.com/shiran009/travel-web/blob/main/src/components/BookingModal.tsx"
click node_bookings "https://github.com/shiran009/travel-web/blob/main/src/components/MyBookingsModal.tsx"
click node_itinerary "https://github.com/shiran009/travel-web/blob/main/src/components/ItineraryBuilder.tsx"
click node_stays "https://github.com/shiran009/travel-web/blob/main/src/components/StaysAndFlights.tsx"
click node_essentials "https://github.com/shiran009/travel-web/blob/main/src/components/TravelEssentialsModal.tsx"
click node_wishlist "https://github.com/shiran009/travel-web/blob/main/src/components/WishlistModal.tsx"
click node_destinations "https://github.com/shiran009/travel-web/blob/main/src/data/destinations.ts"
click node_traveldata "https://github.com/shiran009/travel-web/blob/main/src/data/travelData.ts"
click node_reviews "https://github.com/shiran009/travel-web/blob/main/src/components/ReviewsSection.tsx"
click node_footer "https://github.com/shiran009/travel-web/blob/main/src/components/Footer.tsx"
click node_toast "https://github.com/shiran009/travel-web/blob/main/src/components/Toast.tsx"

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_models,node_formatters,node_toast toneBlue
class node_navbar,node_hero,node_grid,node_card,node_detail toneAmber
class node_booking,node_bookings,node_itinerary,node_stays,node_essentials,node_wishlist toneMint
class node_destinations,node_traveldata,node_reviews,node_footer toneRose
class node_traveler toneIndigo
```

## Components

### Application Shell

- [App State & Routing](https://github.com/shiran009/travel-web/blob/main/src/App.tsx): `src/App.tsx`
- [Travel Types](https://github.com/shiran009/travel-web/blob/main/src/types/travel.ts): `src/types/travel.ts`
- [Pricing & Date Helpers](https://github.com/shiran009/travel-web/blob/main/src/utils/formatters.ts): `src/utils/formatters.ts`
- [Toast Notifications](https://github.com/shiran009/travel-web/blob/main/src/components/Toast.tsx): `src/components/Toast.tsx`

### Travel Discovery

- [Navigation & Currency](https://github.com/shiran009/travel-web/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Search Controls](https://github.com/shiran009/travel-web/blob/main/src/components/HeroSearch.tsx): `src/components/HeroSearch.tsx`
- [Destination Results](https://github.com/shiran009/travel-web/blob/main/src/components/DestinationsGrid.tsx): `src/components/DestinationsGrid.tsx`
- [Destination Card](https://github.com/shiran009/travel-web/blob/main/src/components/DestinationCard.tsx): `src/components/DestinationCard.tsx`
- [Destination Details](https://github.com/shiran009/travel-web/blob/main/src/components/DestinationDetailModal.tsx): `src/components/DestinationDetailModal.tsx`

### Trip Planning

- [Booking Flow](https://github.com/shiran009/travel-web/blob/main/src/components/BookingModal.tsx): `src/components/BookingModal.tsx`
- [Booking Management](https://github.com/shiran009/travel-web/blob/main/src/components/MyBookingsModal.tsx): `src/components/MyBookingsModal.tsx`
- [Custom Itinerary](https://github.com/shiran009/travel-web/blob/main/src/components/ItineraryBuilder.tsx): `src/components/ItineraryBuilder.tsx`
- [Stays & Flights](https://github.com/shiran009/travel-web/blob/main/src/components/StaysAndFlights.tsx): `src/components/StaysAndFlights.tsx`
- [Travel Essentials](https://github.com/shiran009/travel-web/blob/main/src/components/TravelEssentialsModal.tsx): `src/components/TravelEssentialsModal.tsx`
- [Wishlist](https://github.com/shiran009/travel-web/blob/main/src/components/WishlistModal.tsx): `src/components/WishlistModal.tsx`

### Travel Content

- [Curated Destinations](https://github.com/shiran009/travel-web/blob/main/src/data/destinations.ts): `src/data/destinations.ts`
- [Travel Reference Data](https://github.com/shiran009/travel-web/blob/main/src/data/travelData.ts): `src/data/travelData.ts`
- [Traveler Reviews](https://github.com/shiran009/travel-web/blob/main/src/components/ReviewsSection.tsx): `src/components/ReviewsSection.tsx`
- [Footer](https://github.com/shiran009/travel-web/blob/main/src/components/Footer.tsx): `src/components/Footer.tsx`

### Other components

- **Traveler**

## Connections

- Traveler → App State & Routing: uses
- App State & Routing → Navigation & Currency: renders (evidence: `src/App.tsx`)
- App State & Routing → Search Controls: renders (evidence: `src/App.tsx`)
- App State & Routing → Destination Results: renders (evidence: `src/App.tsx`)
- App State & Routing → Destination Details: renders (evidence: `src/App.tsx`)
- App State & Routing → Booking Flow: renders (evidence: `src/App.tsx`)
- App State & Routing → Booking Management: renders (evidence: `src/App.tsx`)
- App State & Routing → Custom Itinerary: renders (evidence: `src/App.tsx`)
- App State & Routing → Stays & Flights: renders (evidence: `src/App.tsx`)
- App State & Routing → Travel Essentials: renders (evidence: `src/App.tsx`)
- App State & Routing → Wishlist: renders (evidence: `src/App.tsx`)
- App State & Routing → Traveler Reviews: renders (evidence: `src/App.tsx`)
- App State & Routing → Footer: renders (evidence: `src/App.tsx`)
- App State & Routing → Toast Notifications: renders (evidence: `src/App.tsx`)
- App State & Routing → Curated Destinations: loads data (evidence: `src/App.tsx`)
- App State & Routing → Travel Reference Data: loads data (evidence: `src/App.tsx`)
- App State & Routing → Travel Types: uses types (evidence: `src/App.tsx`)
- App State & Routing → Pricing & Date Helpers: uses helpers (evidence: `src/App.tsx`)
- Destination Results → Destination Card: renders (evidence: `src/components/DestinationsGrid.tsx`)
- Destination Card → Pricing & Date Helpers: formats prices (evidence: `src/components/DestinationCard.tsx`)
- Destination Details → Pricing & Date Helpers: formats prices (evidence: `src/components/DestinationDetailModal.tsx`)
- Booking Flow → Pricing & Date Helpers: formats booking (evidence: `src/components/BookingModal.tsx`)
- Booking Flow → Curated Destinations: reads add-ons (evidence: `src/components/BookingModal.tsx`)
- Booking Management → Pricing & Date Helpers: formats dates (evidence: `src/components/MyBookingsModal.tsx`)
- Custom Itinerary → Travel Reference Data: loads activities (evidence: `src/components/ItineraryBuilder.tsx`)
- Custom Itinerary → Pricing & Date Helpers: formats plan (evidence: `src/components/ItineraryBuilder.tsx`)
- Stays & Flights → Travel Reference Data: loads options (evidence: `src/components/StaysAndFlights.tsx`)
- Travel Essentials → Travel Reference Data: loads guidance (evidence: `src/components/TravelEssentialsModal.tsx`)
- Traveler Reviews → Travel Types: uses review type (evidence: `src/components/ReviewsSection.tsx`)
- Curated Destinations → Travel Types: uses types (evidence: `src/data/destinations.ts`)
- Travel Reference Data → Travel Types: uses types (evidence: `src/data/travelData.ts`)
