# mnichols08/gcadv architecture

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

- Interactive diagram: https://gitdiagram.com/mnichols08/gcadv
- Repository: https://github.com/mnichols08/gcadv

## Overview

Garrett County Adventures is a browser-based trip planner: visitors explore curated places and trails on a map, inspect or import GPX tracks in Trail Lab, and save outings for offline access. The TypeScript app coordinates map, discovery, analysis, and storage workflows; a separate legacy JavaScript map/search interface and the guide articles are also present. The README documents PWA/offline behavior and Rust/WASM analysis, but sampled excerpts do not expose every worker-to-engine or service-worker interaction.

Main entry points: [`src/app.ts`](https://github.com/mnichols08/gcadv/blob/master/src/app.ts) (Explorer app), [`src/views/components/nav/search/search.component.js`](https://github.com/mnichols08/gcadv/blob/master/src/views/components/nav/search/search.component.js) (Place search), [`src/analysis.worker.ts`](https://github.com/mnichols08/gcadv/blob/master/src/analysis.worker.ts) (Analysis worker), [`src/hikes.ts`](https://github.com/mnichols08/gcadv/blob/master/src/hikes.ts) (Trail discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Trip planning app"]
  node_app["Explorer app<br/>[app.ts]"]
  node_places["Place catalog<br/>[domain.ts]"]
  node_guides["Trip guides"]
  node_storage[("Saved outings<br/>[storage.ts]")]
end

subgraph group_trails["Trail data and analysis"]
  node_worker["Analysis worker<br/>[analysis.worker.ts]"]
  node_wasm["GPX calculations<br/>[lib.rs]"]
  node_hikes["Trail discovery<br/>[hikes.ts]"]
  node_region["Regional clipping<br/>[region.ts]"]
  node_snapshot["Bundled trail data<br/>[hikes.json]"]
end

subgraph group_platform["Browser and map services"]
  node_mapconfig["Map configuration<br/>[map-config.ts]"]
  node_terrain["Terrain controls<br/>[terrain.ts]"]
  node_mapbox["Mapbox map"]
  node_overpass["OpenStreetMap service"]
  node_serviceworker["Offline app shell<br/>[service-worker.js]"]
end

subgraph group_legacy["Legacy map interface"]
  node_controller["Legacy map controller<br/>[controller.js]"]
  node_legacysearch["Place search"]
  node_legacyplaces["Park markers<br/>[park.component.js]"]
  node_legacymap["Legacy map view<br/>[map.component.js]"]
  node_legacyutils["Map interactions<br/>[mapbox.util.js]"]
end

node_visitor(("Trip planner"))
node_gpxfile["GPX track"]

node_visitor -->|"plans trips"| node_app
node_visitor -->|"browses guides"| node_guides
node_visitor -->|"imports track"| node_gpxfile
node_app -->|"filters places"| node_places
node_app -->|"loads token"| node_mapconfig
node_app -->|"reads and writes"| node_storage
node_app -->|"discovers trails"| node_hikes
node_app -->|"applies terrain"| node_terrain
node_app -->|"renders map"| node_mapbox
node_app -.->|"dispatches analysis"| node_worker
node_app -->|"loads bundled trails"| node_snapshot
node_worker -.->|"runs calculations"| node_wasm
node_hikes -->|"clips routes"| node_region
node_app -->|"requests refresh"| node_overpass
node_app -->|"analyzes track"| node_gpxfile
node_app -.->|"uses offline shell"| node_serviceworker
node_visitor -->|"searches parks"| node_legacysearch
node_legacysearch -->|"loads places"| node_controller
node_legacysearch -->|"renders matches"| node_legacyplaces
node_legacyplaces -->|"opens popup"| node_legacyutils
node_legacymap -->|"creates map"| node_controller

click node_app "https://github.com/mnichols08/gcadv/blob/master/src/app.ts"
click node_places "https://github.com/mnichols08/gcadv/blob/master/src/domain.ts"
click node_guides "https://github.com/mnichols08/gcadv/tree/master/content/articles"
click node_storage "https://github.com/mnichols08/gcadv/blob/master/src/storage.ts"
click node_mapconfig "https://github.com/mnichols08/gcadv/blob/master/src/map-config.ts"
click node_terrain "https://github.com/mnichols08/gcadv/blob/master/src/terrain.ts"
click node_worker "https://github.com/mnichols08/gcadv/blob/master/src/analysis.worker.ts"
click node_wasm "https://github.com/mnichols08/gcadv/blob/master/rust/src/lib.rs"
click node_hikes "https://github.com/mnichols08/gcadv/blob/master/src/hikes.ts"
click node_region "https://github.com/mnichols08/gcadv/blob/master/src/region.ts"
click node_snapshot "https://github.com/mnichols08/gcadv/blob/master/src/model/hikes.json"
click node_serviceworker "https://github.com/mnichols08/gcadv/blob/master/src/service-worker.js"
click node_controller "https://github.com/mnichols08/gcadv/blob/master/src/controller.js"
click node_legacysearch "https://github.com/mnichols08/gcadv/blob/master/src/views/components/nav/search/search.component.js"
click node_legacyplaces "https://github.com/mnichols08/gcadv/blob/master/src/views/components/map/parks/park.component.js"
click node_legacymap "https://github.com/mnichols08/gcadv/blob/master/src/views/components/map/map.component.js"
click node_legacyutils "https://github.com/mnichols08/gcadv/blob/master/src/utils/mapbox.util.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_places,node_guides,node_storage toneBlue
class node_worker,node_wasm,node_hikes,node_region,node_snapshot toneAmber
class node_mapconfig,node_terrain,node_mapbox,node_overpass,node_serviceworker toneMint
class node_controller,node_legacysearch,node_legacyplaces,node_legacymap,node_legacyutils toneRose
class node_visitor,node_gpxfile toneIndigo
```

## Components

### Trip planning app

- [Explorer app](https://github.com/mnichols08/gcadv/blob/master/src/app.ts): `src/app.ts`
- [Place catalog](https://github.com/mnichols08/gcadv/blob/master/src/domain.ts): `src/domain.ts`
- [Trip guides](https://github.com/mnichols08/gcadv/tree/master/content/articles): `content/articles`
- [Saved outings](https://github.com/mnichols08/gcadv/blob/master/src/storage.ts): `src/storage.ts`

### Trail data and analysis

- [Analysis worker](https://github.com/mnichols08/gcadv/blob/master/src/analysis.worker.ts): `src/analysis.worker.ts`
- [GPX calculations](https://github.com/mnichols08/gcadv/blob/master/rust/src/lib.rs): `rust/src/lib.rs`
- [Trail discovery](https://github.com/mnichols08/gcadv/blob/master/src/hikes.ts): `src/hikes.ts`
- [Regional clipping](https://github.com/mnichols08/gcadv/blob/master/src/region.ts): `src/region.ts`
- [Bundled trail data](https://github.com/mnichols08/gcadv/blob/master/src/model/hikes.json): `src/model/hikes.json`

### Browser and map services

- [Map configuration](https://github.com/mnichols08/gcadv/blob/master/src/map-config.ts): `src/map-config.ts`
- [Terrain controls](https://github.com/mnichols08/gcadv/blob/master/src/terrain.ts): `src/terrain.ts`
- **Mapbox map**
- **OpenStreetMap service**
- [Offline app shell](https://github.com/mnichols08/gcadv/blob/master/src/service-worker.js): `src/service-worker.js`

### Legacy map interface

- [Legacy map controller](https://github.com/mnichols08/gcadv/blob/master/src/controller.js): `src/controller.js`
- [Place search](https://github.com/mnichols08/gcadv/blob/master/src/views/components/nav/search/search.component.js): `src/views/components/nav/search/search.component.js`
- [Park markers](https://github.com/mnichols08/gcadv/blob/master/src/views/components/map/parks/park.component.js): `src/views/components/map/parks/park.component.js`
- [Legacy map view](https://github.com/mnichols08/gcadv/blob/master/src/views/components/map/map.component.js): `src/views/components/map/map.component.js`
- [Map interactions](https://github.com/mnichols08/gcadv/blob/master/src/utils/mapbox.util.js): `src/utils/mapbox.util.js`

### Other components

- **Trip planner**
- **GPX track**

## Connections

- Trip planner → Explorer app: plans trips (evidence: `README.md`)
- Trip planner → Trip guides: browses guides (evidence: `README.md`)
- Trip planner → GPX track: imports track (evidence: `README.md`)
- Explorer app → Place catalog: filters places (evidence: `src/app.ts`)
- Explorer app → Map configuration: loads token (evidence: `src/app.ts`)
- Explorer app → Saved outings: reads and writes (evidence: `src/app.ts`)
- Explorer app → Trail discovery: discovers trails (evidence: `src/app.ts`)
- Explorer app → Terrain controls: applies terrain (evidence: `src/app.ts`)
- Explorer app → Mapbox map: renders map (evidence: `src/app.ts`)
- Explorer app → Analysis worker: dispatches analysis (evidence: `src/app.ts`)
- Explorer app → Bundled trail data: loads bundled trails (evidence: `src/app.ts`)
- Analysis worker → GPX calculations: runs calculations
- Trail discovery → Regional clipping: clips routes (evidence: `src/hikes.ts`)
- Explorer app → OpenStreetMap service: requests refresh
- Explorer app → GPX track: analyzes track (evidence: `README.md`)
- Explorer app → Offline app shell: uses offline shell (evidence: `README.md`)
- Trip planner → Place search: searches parks (evidence: `src/views/components/nav/search/search.component.js`)
- Place search → Legacy map controller: loads places (evidence: `src/views/components/nav/search/search.component.js`)
- Place search → Park markers: renders matches (evidence: `src/views/components/nav/search/search.component.js`)
- Park markers → Map interactions: opens popup (evidence: `src/utils/mapbox.util.js`)
- Legacy map view → Legacy map controller: creates map (evidence: `src/views/components/map/map.component.js`)
