# ryancjc/altas_fe architecture

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

- Interactive diagram: https://gitdiagram.com/ryancjc/altas_fe
- Repository: https://github.com/ryancjc/altas_fe

## Overview

This is a React trip-planning application for creating, exploring, and editing travel itineraries, then reviewing trip costs and payment status. The main workflow runs from trip setup or a curated itinerary into an App-managed workspace, where travelers review a timeline and map, adjust activities, flights, and stays, and can proceed to finalization or payment. The graph also preserves assistant, archive, airport lookup, and schedule-recalculation capabilities. Some component relationships are supported by the SOURCE INDEX rather than full excerpts; unsampled behavior is not inferred.

Main entry points: [`src/App.tsx`](https://github.com/ryancjc/altas_fe/blob/master/src/App.tsx) (Trip app), [`src/components/TripGenerationPage.tsx`](https://github.com/ryancjc/altas_fe/blob/master/src/components/TripGenerationPage.tsx) (Trip setup), [`src/components/TimelineView.tsx`](https://github.com/ryancjc/altas_fe/blob/master/src/components/TimelineView.tsx) (Trip timeline), [`src/components/ChangeAccommodationModal.tsx`](https://github.com/ryancjc/altas_fe/blob/master/src/components/ChangeAccommodationModal.tsx) (Change accommodation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Trip planning"]
  node_app["Trip app<br/>[App.tsx]"]
  node_trip_setup["Trip setup"]
  node_date_picker["Date picker"]
  node_airport_lookup["Airport lookup"]
  node_explore["Trip explorer<br/>[ExploreView.tsx]"]
  node_archive["Trip archive<br/>[ArchiveView.tsx]"]
end

subgraph group_workspace["Itinerary workspace"]
  node_navigation["Top navigation<br/>[TopNavBar.tsx]"]
  node_assistant["AI co-pilot<br/>[AICoPilot.tsx]"]
  node_timeline["Trip timeline<br/>[TimelineView.tsx]"]
  node_loading_view["Timeline loading"]
  node_map["Trip map<br/>[MapView.tsx]"]
  node_subplanner["Sub-planner bar<br/>[SubPlannerBar.tsx]"]
  node_activity_add["Add activity"]
  node_activity_edit["Edit activity"]
end

subgraph group_booking["Booking and payment"]
  node_flight_change["Change flight"]
  node_stay_change["Change accommodation"]
  node_finalize["Finalize and pay"]
end

subgraph group_shared["Shared data and utilities"]
  node_featured_trips["Featured trips<br/>[featuredTrips.ts]"]
  node_trip_data["Sample trip data<br/>[mockTripData.ts]"]
  node_schedule["Schedule recalculation"]
  node_route_api["Route API helper<br/>[routeApi.ts]"]
  node_time["Time helpers<br/>[time.ts]"]
  node_currency["Currency formatting<br/>[currency.tsx]"]
  node_airports["Airport data<br/>[airports.ts]"]
  node_trip_types["Trip data types<br/>[types.ts]"]
end

node_traveler(("Traveler"))
node_hotel_api{{"Hotel API"}}

node_traveler -->|"uses"| node_app
node_app -->|"renders"| node_trip_setup
node_app -->|"renders"| node_explore
node_app -->|"renders"| node_navigation
node_app -->|"renders"| node_assistant
node_app -->|"renders"| node_timeline
node_app -->|"renders"| node_map
node_app -->|"renders"| node_subplanner
node_app -->|"renders"| node_activity_add
node_app -->|"renders"| node_activity_edit
node_app -->|"renders"| node_flight_change
node_app -->|"renders"| node_stay_change
node_app -->|"renders"| node_finalize
node_app -->|"renders"| node_archive
node_app -->|"loads sample"| node_trip_data
node_app -->|"calls"| node_schedule
node_app -->|"calls"| node_route_api
node_app -->|"uses"| node_time
node_trip_setup -->|"uses"| node_date_picker
node_trip_setup -->|"uses"| node_airport_lookup
node_trip_setup -->|"reads"| node_featured_trips
node_explore -->|"reads"| node_featured_trips
node_airport_lookup -->|"reads"| node_airports
node_timeline -->|"recalculates"| node_schedule
node_timeline -->|"renders"| node_loading_view
node_schedule -->|"uses"| node_time
node_stay_change -->|"fetches hotel options"| node_hotel_api
node_stay_change -->|"formats prices"| node_currency

click node_app "https://github.com/ryancjc/altas_fe/blob/master/src/App.tsx"
click node_trip_setup "https://github.com/ryancjc/altas_fe/blob/master/src/components/TripGenerationPage.tsx"
click node_date_picker "https://github.com/ryancjc/altas_fe/blob/master/src/components/DateRangePicker.tsx"
click node_airport_lookup "https://github.com/ryancjc/altas_fe/blob/master/src/components/AirportAutocomplete.tsx"
click node_explore "https://github.com/ryancjc/altas_fe/blob/master/src/components/ExploreView.tsx"
click node_featured_trips "https://github.com/ryancjc/altas_fe/blob/master/src/data/featuredTrips.ts"
click node_trip_data "https://github.com/ryancjc/altas_fe/blob/master/src/data/mockTripData.ts"
click node_navigation "https://github.com/ryancjc/altas_fe/blob/master/src/components/TopNavBar.tsx"
click node_assistant "https://github.com/ryancjc/altas_fe/blob/master/src/components/AICoPilot.tsx"
click node_timeline "https://github.com/ryancjc/altas_fe/blob/master/src/components/TimelineView.tsx"
click node_loading_view "https://github.com/ryancjc/altas_fe/blob/master/src/components/TimelineLoadingView.tsx"
click node_map "https://github.com/ryancjc/altas_fe/blob/master/src/components/MapView.tsx"
click node_subplanner "https://github.com/ryancjc/altas_fe/blob/master/src/components/SubPlannerBar.tsx"
click node_activity_add "https://github.com/ryancjc/altas_fe/blob/master/src/components/AddActivityModal.tsx"
click node_activity_edit "https://github.com/ryancjc/altas_fe/blob/master/src/components/EditActivityModal.tsx"
click node_flight_change "https://github.com/ryancjc/altas_fe/blob/master/src/components/ChangeFlightModal.tsx"
click node_stay_change "https://github.com/ryancjc/altas_fe/blob/master/src/components/ChangeAccommodationModal.tsx"
click node_finalize "https://github.com/ryancjc/altas_fe/blob/master/src/components/FinalizePayView.tsx"
click node_archive "https://github.com/ryancjc/altas_fe/blob/master/src/components/ArchiveView.tsx"
click node_schedule "https://github.com/ryancjc/altas_fe/blob/master/src/utils/recalculateSchedule.ts"
click node_route_api "https://github.com/ryancjc/altas_fe/blob/master/src/utils/routeApi.ts"
click node_time "https://github.com/ryancjc/altas_fe/blob/master/src/utils/time.ts"
click node_currency "https://github.com/ryancjc/altas_fe/blob/master/src/currency.tsx"
click node_airports "https://github.com/ryancjc/altas_fe/blob/master/src/data/airports.ts"
click node_trip_types "https://github.com/ryancjc/altas_fe/blob/master/src/types.ts"

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_trip_setup,node_date_picker,node_airport_lookup,node_explore,node_archive toneBlue
class node_navigation,node_assistant,node_timeline,node_loading_view,node_map,node_subplanner,node_activity_add,node_activity_edit toneAmber
class node_flight_change,node_stay_change,node_finalize,node_hotel_api toneMint
class node_featured_trips,node_trip_data,node_schedule,node_route_api,node_time,node_currency,node_airports,node_trip_types toneRose
class node_traveler toneIndigo
```

## Components

### Trip planning

- [Trip app](https://github.com/ryancjc/altas_fe/blob/master/src/App.tsx): `src/App.tsx`
- [Trip setup](https://github.com/ryancjc/altas_fe/blob/master/src/components/TripGenerationPage.tsx): `src/components/TripGenerationPage.tsx`
- [Date picker](https://github.com/ryancjc/altas_fe/blob/master/src/components/DateRangePicker.tsx): `src/components/DateRangePicker.tsx`
- [Airport lookup](https://github.com/ryancjc/altas_fe/blob/master/src/components/AirportAutocomplete.tsx): `src/components/AirportAutocomplete.tsx`
- [Trip explorer](https://github.com/ryancjc/altas_fe/blob/master/src/components/ExploreView.tsx): `src/components/ExploreView.tsx`
- [Trip archive](https://github.com/ryancjc/altas_fe/blob/master/src/components/ArchiveView.tsx): `src/components/ArchiveView.tsx`

### Itinerary workspace

- [Top navigation](https://github.com/ryancjc/altas_fe/blob/master/src/components/TopNavBar.tsx): `src/components/TopNavBar.tsx`
- [AI co-pilot](https://github.com/ryancjc/altas_fe/blob/master/src/components/AICoPilot.tsx): `src/components/AICoPilot.tsx`
- [Trip timeline](https://github.com/ryancjc/altas_fe/blob/master/src/components/TimelineView.tsx): `src/components/TimelineView.tsx`
- [Timeline loading](https://github.com/ryancjc/altas_fe/blob/master/src/components/TimelineLoadingView.tsx): `src/components/TimelineLoadingView.tsx`
- [Trip map](https://github.com/ryancjc/altas_fe/blob/master/src/components/MapView.tsx): `src/components/MapView.tsx`
- [Sub-planner bar](https://github.com/ryancjc/altas_fe/blob/master/src/components/SubPlannerBar.tsx): `src/components/SubPlannerBar.tsx`
- [Add activity](https://github.com/ryancjc/altas_fe/blob/master/src/components/AddActivityModal.tsx): `src/components/AddActivityModal.tsx`
- [Edit activity](https://github.com/ryancjc/altas_fe/blob/master/src/components/EditActivityModal.tsx): `src/components/EditActivityModal.tsx`

### Booking and payment

- [Change flight](https://github.com/ryancjc/altas_fe/blob/master/src/components/ChangeFlightModal.tsx): `src/components/ChangeFlightModal.tsx`
- [Change accommodation](https://github.com/ryancjc/altas_fe/blob/master/src/components/ChangeAccommodationModal.tsx): `src/components/ChangeAccommodationModal.tsx`
- [Finalize and pay](https://github.com/ryancjc/altas_fe/blob/master/src/components/FinalizePayView.tsx): `src/components/FinalizePayView.tsx`

### Shared data and utilities

- [Featured trips](https://github.com/ryancjc/altas_fe/blob/master/src/data/featuredTrips.ts): `src/data/featuredTrips.ts`
- [Sample trip data](https://github.com/ryancjc/altas_fe/blob/master/src/data/mockTripData.ts): `src/data/mockTripData.ts`
- [Schedule recalculation](https://github.com/ryancjc/altas_fe/blob/master/src/utils/recalculateSchedule.ts): `src/utils/recalculateSchedule.ts`
- [Route API helper](https://github.com/ryancjc/altas_fe/blob/master/src/utils/routeApi.ts): `src/utils/routeApi.ts`
- [Time helpers](https://github.com/ryancjc/altas_fe/blob/master/src/utils/time.ts): `src/utils/time.ts`
- [Currency formatting](https://github.com/ryancjc/altas_fe/blob/master/src/currency.tsx): `src/currency.tsx`
- [Airport data](https://github.com/ryancjc/altas_fe/blob/master/src/data/airports.ts): `src/data/airports.ts`
- [Trip data types](https://github.com/ryancjc/altas_fe/blob/master/src/types.ts): `src/types.ts`

### Other components

- **Traveler**
- **Hotel API**

## Connections

- Traveler → Trip app: uses
- Trip app → Trip setup: renders (evidence: `src/App.tsx`)
- Trip app → Trip explorer: renders (evidence: `src/App.tsx`)
- Trip app → Top navigation: renders (evidence: `src/App.tsx`)
- Trip app → AI co-pilot: renders (evidence: `src/App.tsx`)
- Trip app → Trip timeline: renders (evidence: `src/App.tsx`)
- Trip app → Trip map: renders (evidence: `src/App.tsx`)
- Trip app → Sub-planner bar: renders (evidence: `src/App.tsx`)
- Trip app → Add activity: renders (evidence: `src/App.tsx`)
- Trip app → Edit activity: renders (evidence: `src/App.tsx`)
- Trip app → Change flight: renders (evidence: `src/App.tsx`)
- Trip app → Change accommodation: renders (evidence: `src/App.tsx`)
- Trip app → Finalize and pay: renders (evidence: `src/App.tsx`)
- Trip app → Trip archive: renders (evidence: `src/App.tsx`)
- Trip app → Sample trip data: loads sample (evidence: `src/App.tsx`)
- Trip app → Schedule recalculation: calls (evidence: `src/App.tsx`)
- Trip app → Route API helper: calls (evidence: `src/App.tsx`)
- Trip app → Time helpers: uses (evidence: `src/App.tsx`)
- Trip setup → Date picker: uses (evidence: `src/components/TripGenerationPage.tsx`)
- Trip setup → Airport lookup: uses (evidence: `src/components/TripGenerationPage.tsx`)
- Trip setup → Featured trips: reads (evidence: `src/components/TripGenerationPage.tsx`)
- Trip explorer → Featured trips: reads (evidence: `src/components/ExploreView.tsx`)
- Airport lookup → Airport data: reads (evidence: `src/components/AirportAutocomplete.tsx`)
- Trip timeline → Schedule recalculation: recalculates (evidence: `src/components/TimelineView.tsx`)
- Trip timeline → Timeline loading: renders (evidence: `src/components/TimelineView.tsx`)
- Schedule recalculation → Time helpers: uses (evidence: `src/utils/recalculateSchedule.ts`)
- Change accommodation → Hotel API: fetches hotel options (evidence: `src/components/ChangeAccommodationModal.tsx`)
- Change accommodation → Currency formatting: formats prices (evidence: `src/components/ChangeAccommodationModal.tsx`)
