# code-royal/vcs-group-coursework architecture

> Architecture diagram of the GitHub repository code-royal/vcs-group-coursework, 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/code-royal/vcs-group-coursework
- Repository: https://github.com/code-royal/vcs-group-coursework

## Overview

Explore Kathmandu is a static, browser-only travel guide. Visitors browse and filter destinations, open destination details, and build a day-by-day itinerary with a budget; favorites and demo account state are also browser-local. The graph includes the README-documented guide, profile, theme, and feedback features. Source excerpts show destination data/rendering, detail lookup, login gating, and theme persistence; other page behavior and storage links rely on README documentation, not inspected page source.

Main entry points: [`js/destinations.js`](https://github.com/code-royal/vcs-group-coursework/blob/main/js/destinations.js) (Destination catalog), [`js/script.js`](https://github.com/code-royal/vcs-group-coursework/blob/main/js/script.js) (Theme toggle), [`explore.html`](https://github.com/code-royal/vcs-group-coursework/blob/main/explore.html) (Explore destinations), [`details.html`](https://github.com/code-royal/vcs-group-coursework/blob/main/details.html) (Destination details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Destination discovery"]
  node_home["Home<br/>[index.html]"]
  node_explore["Explore destinations<br/>[explore.html]"]
  node_catalog["Destination catalog<br/>[destinations.js]"]
  node_details["Destination details<br/>[details.html]"]
  node_detail_renderer["Detail renderer<br/>[destinations.js]"]
end

subgraph group_planning["Trip planning"]
  node_itinerary["Itinerary planner<br/>[itinerary.html]"]
  node_browser_storage[("Browser storage")]
end

subgraph group_accounts["Accounts and profile"]
  node_signup["Sign up<br/>[signup.html]"]
  node_login["Log in<br/>[login.html]"]
  node_profile["Profile and favorites<br/>[profile.html]"]
  node_login_gate["Login gate<br/>[destinations.js]"]
end

subgraph group_site["Site experience"]
  node_guide["Travel guide<br/>[guide.html]"]
  node_about["About and feedback<br/>[about.html]"]
  node_theme["Theme toggle<br/>[script.js]"]
  node_styles["Site styling<br/>[style.css]"]
end

node_traveler(("Traveler"))

node_traveler -->|"opens"| node_home
node_traveler -->|"browses"| node_explore
node_explore -->|"searches and filters"| node_catalog
node_catalog -->|"opens by destination"| node_details
node_details -->|"loads destination"| node_detail_renderer
node_traveler -->|"plans trip"| node_itinerary
node_itinerary -->|"persists plan"| node_browser_storage
node_traveler -->|"creates demo account"| node_signup
node_traveler -->|"starts demo session"| node_login
node_login -->|"stores session state"| node_browser_storage
node_signup -->|"stores session state"| node_browser_storage
node_profile -->|"reads favorites"| node_browser_storage
node_traveler -->|"views saved items"| node_profile
node_catalog -->|"gates favorite action"| node_login_gate
node_login_gate -->|"checks session"| node_browser_storage
node_traveler -->|"reads tips"| node_guide
node_traveler -->|"sends feedback"| node_about
node_traveler -->|"toggles theme"| node_theme
node_theme -->|"saves preference"| node_browser_storage
node_theme -->|"applies theme class"| node_styles

click node_home "https://github.com/code-royal/vcs-group-coursework/blob/main/index.html"
click node_explore "https://github.com/code-royal/vcs-group-coursework/blob/main/explore.html"
click node_catalog "https://github.com/code-royal/vcs-group-coursework/blob/main/js/destinations.js"
click node_details "https://github.com/code-royal/vcs-group-coursework/blob/main/details.html"
click node_detail_renderer "https://github.com/code-royal/vcs-group-coursework/blob/main/js/destinations.js"
click node_itinerary "https://github.com/code-royal/vcs-group-coursework/blob/main/itinerary.html"
click node_signup "https://github.com/code-royal/vcs-group-coursework/blob/main/signup.html"
click node_login "https://github.com/code-royal/vcs-group-coursework/blob/main/login.html"
click node_profile "https://github.com/code-royal/vcs-group-coursework/blob/main/profile.html"
click node_login_gate "https://github.com/code-royal/vcs-group-coursework/blob/main/js/destinations.js"
click node_guide "https://github.com/code-royal/vcs-group-coursework/blob/main/guide.html"
click node_about "https://github.com/code-royal/vcs-group-coursework/blob/main/about.html"
click node_theme "https://github.com/code-royal/vcs-group-coursework/blob/main/js/script.js"
click node_styles "https://github.com/code-royal/vcs-group-coursework/blob/main/css/style.css"

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_home,node_explore,node_catalog,node_details,node_detail_renderer toneBlue
class node_itinerary,node_browser_storage toneAmber
class node_signup,node_login,node_profile,node_login_gate toneMint
class node_guide,node_about,node_theme,node_styles toneRose
class node_traveler toneIndigo
```

## Components

### Destination discovery

- [Home](https://github.com/code-royal/vcs-group-coursework/blob/main/index.html): `index.html`
- [Explore destinations](https://github.com/code-royal/vcs-group-coursework/blob/main/explore.html): `explore.html`
- [Destination catalog](https://github.com/code-royal/vcs-group-coursework/blob/main/js/destinations.js): `js/destinations.js`
- [Destination details](https://github.com/code-royal/vcs-group-coursework/blob/main/details.html): `details.html`
- [Detail renderer](https://github.com/code-royal/vcs-group-coursework/blob/main/js/destinations.js): `js/destinations.js`

### Trip planning

- [Itinerary planner](https://github.com/code-royal/vcs-group-coursework/blob/main/itinerary.html): `itinerary.html`
- **Browser storage**

### Accounts and profile

- [Sign up](https://github.com/code-royal/vcs-group-coursework/blob/main/signup.html): `signup.html`
- [Log in](https://github.com/code-royal/vcs-group-coursework/blob/main/login.html): `login.html`
- [Profile and favorites](https://github.com/code-royal/vcs-group-coursework/blob/main/profile.html): `profile.html`
- [Login gate](https://github.com/code-royal/vcs-group-coursework/blob/main/js/destinations.js): `js/destinations.js`

### Site experience

- [Travel guide](https://github.com/code-royal/vcs-group-coursework/blob/main/guide.html): `guide.html`
- [About and feedback](https://github.com/code-royal/vcs-group-coursework/blob/main/about.html): `about.html`
- [Theme toggle](https://github.com/code-royal/vcs-group-coursework/blob/main/js/script.js): `js/script.js`
- [Site styling](https://github.com/code-royal/vcs-group-coursework/blob/main/css/style.css): `css/style.css`

### Other components

- **Traveler**

## Connections

- Traveler → Home: opens (evidence: `README.md`)
- Traveler → Explore destinations: browses (evidence: `README.md`)
- Explore destinations → Destination catalog: searches and filters (evidence: `README.md`)
- Destination catalog → Destination details: opens by destination (evidence: `README.md`)
- Destination details → Detail renderer: loads destination (evidence: `js/destinations.js`)
- Traveler → Itinerary planner: plans trip (evidence: `README.md`)
- Itinerary planner → Browser storage: persists plan (evidence: `README.md`)
- Traveler → Sign up: creates demo account (evidence: `README.md`)
- Traveler → Log in: starts demo session (evidence: `README.md`)
- Log in → Browser storage: stores session state (evidence: `README.md`)
- Sign up → Browser storage: stores session state (evidence: `README.md`)
- Profile and favorites → Browser storage: reads favorites (evidence: `README.md`)
- Traveler → Profile and favorites: views saved items (evidence: `README.md`)
- Destination catalog → Login gate: gates favorite action (evidence: `js/destinations.js`)
- Login gate → Browser storage: checks session
- Traveler → Travel guide: reads tips (evidence: `README.md`)
- Traveler → About and feedback: sends feedback (evidence: `README.md`)
- Traveler → Theme toggle: toggles theme (evidence: `js/script.js`)
- Theme toggle → Browser storage: saves preference (evidence: `js/script.js`)
- Theme toggle → Site styling: applies theme class (evidence: `js/script.js`)
