# kerkaryashashri/outwiththenest architecture

> Architecture diagram of the GitHub repository kerkaryashashri/outwiththenest, 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/kerkaryashashri/outwiththenest
- Repository: https://github.com/kerkaryashashri/outwiththenest

## Overview

Out With The Nest is an AEM-backed family activity discovery site, with a generated static preview. The main visitor journey is browsing activity categories and listings, narrowing or searching places, opening a venue guide, then reviewing practical details and map directions. AEM supplies reusable page components, authored content and Sling Models; the postcode service supports place-map data. The README documents additional AEM capabilities not present in sampled source. The static preview builder and its authored-content input are included because the README describes them as the way the demo is generated; unsampled wiring is not assumed.

Main entry points: [`ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/placedetailhero`](https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/placedetailhero) (Venue Guide), [`ui.apps/src/main/content/jcr_root/apps/outwiththenest/components`](https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.apps/src/main/content/jcr_root/apps/outwiththenest/components) (AEM Site), [`scripts/build-things-to-do-demo.mjs`](https://github.com/kerkaryashashri/outwiththenest/blob/main/scripts/build-things-to-do-demo.mjs) (Things To Do Builder), [`core/src/main/java/com/outwiththenest/core/models/DiscoveryListingModel.java`](https://github.com/kerkaryashashri/outwiththenest/blob/main/core/src/main/java/com/outwiththenest/core/models/DiscoveryListingModel.java) (Discovery Listings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["AEM Experience"]
  node_aem["AEM Site<br/>[components]"]
  node_navigation["Header &amp; Navigation<br/>[header]"]
  node_activitycards["Activity Cards<br/>[placecard]"]
  node_listings["Discovery Listings"]
  node_search["Activity Search"]
  node_venueguide["Venue Guide<br/>[placedetailhero]"]
  node_placeabout["Place Details<br/>[placeabout]"]
  node_practical["Practical Info<br/>[placepracticalinfo]"]
  node_mapview["Visit Map"]
end

subgraph group_content["Authored Content"]
  node_contentpages[("Activity Pages<br/>[content]")]
  node_templates["Page Templates<br/>[templates]"]
  node_dam[("DAM Assets<br/>[outwiththenest]")]
end

subgraph group_services["AEM Services"]
  node_postcode["Postcode Lookup"]
end

subgraph group_preview["Static Preview"]
  node_demo["Static Demo Pages"]
  node_demoentry["Demo Generator<br/>[build-demo.mjs]"]
  node_thingsbuilder["Things To Do Builder"]
  node_assetcopy["Demo Asset Export<br/>[demo-assets.mjs]"]
  node_demoui["Demo UI Helpers<br/>[demo-ui.mjs]"]
end

node_families(("Families"))
node_postcodeapi["Postcodes.io"]
node_browser(("Preview Browser"))

node_families -->|"browse"| node_aem
node_aem -->|"renders"| node_navigation
node_aem -.->|"renders"| node_listings
node_listings -->|"creates cards"| node_activitycards
node_families -->|"searches activities"| node_search
node_search -->|"reads pages"| node_contentpages
node_listings -->|"reads child pages"| node_contentpages
node_families -->|"opens place"| node_venueguide
node_venueguide -->|"presents details"| node_placeabout
node_venueguide -->|"presents details"| node_practical
node_venueguide -->|"shows directions"| node_mapview
node_mapview -->|"looks up postcode"| node_postcode
node_postcode -->|"requests location"| node_postcodeapi
node_aem -->|"uses templates"| node_templates
node_venueguide -->|"uses photography"| node_dam
node_contentpages -->|"provides authored content"| node_demoentry
node_demoentry -->|"calls builder"| node_thingsbuilder
node_thingsbuilder -->|"exports assets"| node_assetcopy
node_thingsbuilder -->|"uses UI helpers"| node_demoui
node_assetcopy -->|"copies DAM images"| node_dam
node_thingsbuilder -->|"writes pages"| node_demo
node_browser -->|"browses"| node_demo

click node_aem "https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.apps/src/main/content/jcr_root/apps/outwiththenest/components"
click node_navigation "https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/header"
click node_activitycards "https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/placecard"
click node_listings "https://github.com/kerkaryashashri/outwiththenest/blob/main/core/src/main/java/com/outwiththenest/core/models/DiscoveryListingModel.java"
click node_search "https://github.com/kerkaryashashri/outwiththenest/blob/main/core/src/main/java/com/outwiththenest/core/models/AdventureSearchResultsModel.java"
click node_venueguide "https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/placedetailhero"
click node_placeabout "https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/placeabout"
click node_practical "https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/placepracticalinfo"
click node_mapview "https://github.com/kerkaryashashri/outwiththenest/blob/main/core/src/main/java/com/outwiththenest/core/models/PlaceVisitMapModel.java"
click node_contentpages "https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.content/src/main/content/jcr_root/content"
click node_templates "https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.content/src/main/content/jcr_root/conf/outwiththenest/settings/wcm/templates"
click node_dam "https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.content/src/main/content/jcr_root/content/dam/outwiththenest"
click node_postcode "https://github.com/kerkaryashashri/outwiththenest/blob/main/core/src/main/java/com/outwiththenest/core/services/impl/PostcodeLookupServiceImpl.java"
click node_demo "https://github.com/kerkaryashashri/outwiththenest/tree/main/docs"
click node_demoentry "https://github.com/kerkaryashashri/outwiththenest/blob/main/scripts/build-demo.mjs"
click node_thingsbuilder "https://github.com/kerkaryashashri/outwiththenest/blob/main/scripts/build-things-to-do-demo.mjs"
click node_assetcopy "https://github.com/kerkaryashashri/outwiththenest/blob/main/scripts/demo-assets.mjs"
click node_demoui "https://github.com/kerkaryashashri/outwiththenest/blob/main/scripts/demo-ui.mjs"

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_aem,node_navigation,node_activitycards,node_listings,node_search,node_venueguide,node_placeabout,node_practical,node_mapview,node_browser toneBlue
class node_contentpages,node_templates,node_dam toneAmber
class node_postcode toneMint
class node_demo,node_demoentry,node_thingsbuilder,node_assetcopy,node_demoui toneRose
class node_families,node_postcodeapi toneIndigo
```

## Components

### AEM Experience

- [AEM Site](https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.apps/src/main/content/jcr_root/apps/outwiththenest/components): `ui.apps/src/main/content/jcr_root/apps/outwiththenest/components`
- [Header & Navigation](https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/header): `ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/header`
- [Activity Cards](https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/placecard): `ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/placecard`
- [Discovery Listings](https://github.com/kerkaryashashri/outwiththenest/blob/main/core/src/main/java/com/outwiththenest/core/models/DiscoveryListingModel.java): `core/src/main/java/com/outwiththenest/core/models/DiscoveryListingModel.java`
- [Activity Search](https://github.com/kerkaryashashri/outwiththenest/blob/main/core/src/main/java/com/outwiththenest/core/models/AdventureSearchResultsModel.java): `core/src/main/java/com/outwiththenest/core/models/AdventureSearchResultsModel.java`
- [Venue Guide](https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/placedetailhero): `ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/placedetailhero`
- [Place Details](https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/placeabout): `ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/placeabout`
- [Practical Info](https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/placepracticalinfo): `ui.apps/src/main/content/jcr_root/apps/outwiththenest/components/placepracticalinfo`
- [Visit Map](https://github.com/kerkaryashashri/outwiththenest/blob/main/core/src/main/java/com/outwiththenest/core/models/PlaceVisitMapModel.java): `core/src/main/java/com/outwiththenest/core/models/PlaceVisitMapModel.java`

### Authored Content

- [Activity Pages](https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.content/src/main/content/jcr_root/content): `ui.content/src/main/content/jcr_root/content`
- [Page Templates](https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.content/src/main/content/jcr_root/conf/outwiththenest/settings/wcm/templates): `ui.content/src/main/content/jcr_root/conf/outwiththenest/settings/wcm/templates`
- [DAM Assets](https://github.com/kerkaryashashri/outwiththenest/tree/main/ui.content/src/main/content/jcr_root/content/dam/outwiththenest): `ui.content/src/main/content/jcr_root/content/dam/outwiththenest`

### AEM Services

- [Postcode Lookup](https://github.com/kerkaryashashri/outwiththenest/blob/main/core/src/main/java/com/outwiththenest/core/services/impl/PostcodeLookupServiceImpl.java): `core/src/main/java/com/outwiththenest/core/services/impl/PostcodeLookupServiceImpl.java`

### Static Preview

- [Static Demo Pages](https://github.com/kerkaryashashri/outwiththenest/tree/main/docs): `docs`
- [Demo Generator](https://github.com/kerkaryashashri/outwiththenest/blob/main/scripts/build-demo.mjs): `scripts/build-demo.mjs`
- [Things To Do Builder](https://github.com/kerkaryashashri/outwiththenest/blob/main/scripts/build-things-to-do-demo.mjs): `scripts/build-things-to-do-demo.mjs`
- [Demo Asset Export](https://github.com/kerkaryashashri/outwiththenest/blob/main/scripts/demo-assets.mjs): `scripts/demo-assets.mjs`
- [Demo UI Helpers](https://github.com/kerkaryashashri/outwiththenest/blob/main/scripts/demo-ui.mjs): `scripts/demo-ui.mjs`

### Other components

- **Families**
- **Postcodes.io**
- **Preview Browser**

## Connections

- Families → AEM Site: browse (evidence: `README.md`)
- AEM Site → Header & Navigation: renders (evidence: `README.md`)
- AEM Site → Discovery Listings: renders
- Discovery Listings → Activity Cards: creates cards (evidence: `core/src/main/java/com/outwiththenest/core/models/DiscoveryListingModel.java`)
- Families → Activity Search: searches activities (evidence: `README.md`)
- Activity Search → Activity Pages: reads pages (evidence: `core/src/main/java/com/outwiththenest/core/models/AdventureSearchResultsModel.java`)
- Discovery Listings → Activity Pages: reads child pages (evidence: `core/src/main/java/com/outwiththenest/core/models/DiscoveryListingModel.java`)
- Families → Venue Guide: opens place (evidence: `README.md`)
- Venue Guide → Place Details: presents details (evidence: `README.md`)
- Venue Guide → Practical Info: presents details (evidence: `README.md`)
- Venue Guide → Visit Map: shows directions (evidence: `README.md`)
- Visit Map → Postcode Lookup: looks up postcode (evidence: `core/src/main/java/com/outwiththenest/core/models/PlaceVisitMapModel.java`)
- Postcode Lookup → Postcodes.io: requests location (evidence: `core/src/main/java/com/outwiththenest/core/services/impl/PostcodeLookupServiceImpl.java`)
- AEM Site → Page Templates: uses templates (evidence: `README.md`)
- Venue Guide → DAM Assets: uses photography (evidence: `README.md`)
- Activity Pages → Demo Generator: provides authored content (evidence: `README.md`)
- Demo Generator → Things To Do Builder: calls builder (evidence: `scripts/build-demo.mjs`)
- Things To Do Builder → Demo Asset Export: exports assets (evidence: `scripts/build-things-to-do-demo.mjs`)
- Things To Do Builder → Demo UI Helpers: uses UI helpers (evidence: `scripts/build-things-to-do-demo.mjs`)
- Demo Asset Export → DAM Assets: copies DAM images (evidence: `scripts/demo-assets.mjs`)
- Things To Do Builder → Static Demo Pages: writes pages (evidence: `scripts/build-things-to-do-demo.mjs`)
- Preview Browser → Static Demo Pages: browses (evidence: `README.md`)
