# roperev/ams-dsp-lts architecture

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

- Interactive diagram: https://gitdiagram.com/roperev/ams-dsp-lts
- Repository: https://github.com/roperev/ams-dsp-lts

## Overview

##### Project type and purpose
- This is an AEM (Adobe Experience Manager) Cloud Service boilerplate / “Helix”‐based front-end project. It provides a pattern for building WYSIWYG‐authorable, block-based web pages delivered both via AEM author/publish and via an Edge Delivery network.

##### File structure
- Top level:
- `.github/workflows/…` – CI/CD pipelines (GitHub Actions) for cleanup, build, deploy
- `fstab.yaml`, `helix-query.yaml`, `helix-sitemap.yaml`, `paths.json` – Helix routing & configuration for edge deployment
- `blocks/`, `models/`, `component-*.json` – Definitions of AEM blocks, content models, filters & component metadata
- `scripts/` – Front-end JavaScript (editor support, AEM proxy integration, client features)
- `styles/` – Global CSS, lazy-loading, fonts
- `tools/sidekick` – Helix Sidekick extension for local editing & debugging
- `head.html` – HTML snippet inserted into `<head>` for fonts, meta, scripts
- `package.json` – Node tooling, Helix CLI, dev scripts

##### README for additional insights
- Project uses AEM Cloud Service (LTS ≥ 2024.8) and Helix Edge Delivery
- Local dev: `@adobe/aem-cli` + `aem up` → AEM proxy on `localhost:3000`
- Blocks are created via JSON descriptors & accompany CSS/JS
- CI/CD through GitHub Actions & AEM Code Sync App

##### Detail over simplicity
- Block definitions, client libs, templates separately
- Local dev vs. production endpoints

## Diagram (Mermaid)

```mermaid
graph TB
  %% Development Layer
  subgraph "Development Layer"
    DevWork["Developer Workstation"]:::dev
    GitRepo["GitHub Repo"]:::dev
    subgraph "CI/CD Pipelines"
      CI_Cleanup["cleanup-on-create.yaml"]:::dev
      CI_Main["main.yaml"]:::dev
    end
    subgraph "Helix Routing & Edge Config"
      FSTAB["fstab.yaml"]:::dev
      HelixQuery["helix-query.yaml"]:::dev
      HelixSitemap["helix-sitemap.yaml"]:::dev
      PathsJSON["paths.json"]:::dev
    end
    HelixCLI["Helix CLI & Local Proxy"]:::dev
    AEMCLI["AEM CLI"]:::dev
    Scripts["Front-end Scripts"]:::dev
    Styles["Global Styles"]:::dev
    Sidekick["Helix Sidekick Extension"]:::dev
    HeadHTML["Head HTML Snippet"]:::dev
    subgraph "Node Tooling & Dev Scripts"
      PackageJSON["package.json"]:::dev
      PackageLock["package-lock.json"]:::dev
      ESLint[".eslintrc.js"]:::dev
      StyleLint[".stylelintrc.json"]:::dev
      Husky[".husky/pre-commit"]:::dev
    end
  end

  %% Authoring & Publishing Layer
  subgraph "Authoring & Publishing Layer"
    AEMAuth["AEM Author"]:::aem
    subgraph "Block Definitions"
      Blocks["blocks/"]:::aem
    end
    subgraph "Content Models & Metadata"
      DefJSON["component-definition.json"]:::aem
      FiltersJSON["component-filters.json"]:::aem
      ModelsJSON["component-models.json"]:::aem
      ModelsDir["models/"]:::aem
    end
    ClientLibs["Client Libraries"]:::aem
    AEMPub["AEM Publish"]:::aem
  end

  %% Delivery Layer
  subgraph "Delivery Layer"
    HelixEdge["Helix Edge Delivery"]:::edge
    CDN["Global CDN"]:::edge
    EndUser["Browser / End-User"]:::browser
  end

  %% Connections
  DevWork --> GitRepo
  GitRepo --> CI_Cleanup
  GitRepo --> CI_Main
  CI_Cleanup --> AEMAuth
  CI_Main --> AEMAuth
  GitRepo --> HelixCLI
  HelixCLI --- AEMCLI
  HelixCLI --> HelixEdge
  AEMAuth --> ClientLibs
  ClientLibs --> AEMPub
  AEMAuth --> AEMPub
  AEMPub --> HelixEdge
  HelixEdge --> CDN
  CDN --> EndUser
  HelixEdge --> AEMPub

  %% Click Events
  click CI_Cleanup "https://github.com/roperev/ams-dsp-lts/blob/main/.github/workflows/cleanup-on-create.yaml"
  click CI_Main "https://github.com/roperev/ams-dsp-lts/blob/main/.github/workflows/main.yaml"
  click FSTAB "https://github.com/roperev/ams-dsp-lts/blob/main/fstab.yaml"
  click HelixQuery "https://github.com/roperev/ams-dsp-lts/blob/main/helix-query.yaml"
  click HelixSitemap "https://github.com/roperev/ams-dsp-lts/blob/main/helix-sitemap.yaml"
  click PathsJSON "https://github.com/roperev/ams-dsp-lts/blob/main/paths.json"
  click Blocks "https://github.com/roperev/ams-dsp-lts/tree/main/blocks/"
  click DefJSON "https://github.com/roperev/ams-dsp-lts/blob/main/component-definition.json"
  click FiltersJSON "https://github.com/roperev/ams-dsp-lts/blob/main/component-filters.json"
  click ModelsJSON "https://github.com/roperev/ams-dsp-lts/blob/main/component-models.json"
  click ModelsDir "https://github.com/roperev/ams-dsp-lts/tree/main/models/"
  click Scripts "https://github.com/roperev/ams-dsp-lts/tree/main/scripts/"
  click Styles "https://github.com/roperev/ams-dsp-lts/tree/main/styles/"
  click Sidekick "https://github.com/roperev/ams-dsp-lts/tree/main/tools/sidekick/"
  click HeadHTML "https://github.com/roperev/ams-dsp-lts/blob/main/head.html"
  click PackageJSON "https://github.com/roperev/ams-dsp-lts/blob/main/package.json"
  click PackageLock "https://github.com/roperev/ams-dsp-lts/blob/main/package-lock.json"
  click ESLint "https://github.com/roperev/ams-dsp-lts/blob/main/.eslintrc.js"
  click StyleLint "https://github.com/roperev/ams-dsp-lts/blob/main/.stylelintrc.json"
  click Husky "https://github.com/roperev/ams-dsp-lts/blob/main/.husky/pre-commit.mjs"

  %% Styles
  classDef dev fill:#D0E4F5,stroke:#0366d6,stroke-width:1px
  classDef aem fill:#D5E8D4,stroke:#22863a,stroke-width:1px
  classDef edge fill:#F8CECC,stroke:#cb2431,stroke-width:1px
  classDef browser fill:#E1E1E1,stroke:#6a737d,stroke-width:1px
```
