# argoproj/argocd-example-apps architecture

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

- Interactive diagram: https://gitdiagram.com/argoproj/argocd-example-apps
- Repository: https://github.com/argoproj/argocd-example-apps

## Overview

This repository is a catalog of deployable Argo CD demo applications, not an application runtime. Its principal workflow is for an operator to register the repository with Argo CD and use its examples to explore GitOps; the `apps` example specifically demonstrates composing and synchronizing other apps. The README documents the examples’ capabilities, but no source excerpts were provided, so relationships between individual examples are omitted unless the README states them.

Main entry points: [`apps/templates/applications.yaml`](https://github.com/argoproj/argocd-example-apps/blob/master/apps/templates/applications.yaml) (Composed Apps)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app_composition["App Composition"]
  node_apps["Composed Apps<br/>[applications.yaml]"]
end

subgraph group_generators["ApplicationSets"]
  node_applicationset["Generator Examples"]
end

subgraph group_deployment["Deployment Patterns"]
  node_blue_green["Blue-Green Rollout<br/>[rollout.yaml]"]
  node_helm_hooks["Helm Hooks<br/>[manifests.yaml]"]
  node_pre_post_sync["Pre/Post Sync<br/>[kustomization.yaml]"]
  node_sync_waves["Sync Waves<br/>[manifests.yaml]"]
end

subgraph group_manifests["Guestbook Formats"]
  node_guestbook["Plain YAML Guestbook"]
  node_helm_dependency["Upstream Helm Customization<br/>[Chart.yaml]"]
  node_helm_guestbook["Helm Guestbook<br/>[Chart.yaml]"]
  node_jsonnet_guestbook["Jsonnet Guestbook"]
  node_jsonnet_tla["Jsonnet with Arguments"]
  node_kustomize_guestbook["Kustomize Guestbook<br/>[kustomization.yaml]"]
  node_sock_shop["Microservices Demo<br/>[kustomization.yaml]"]
end

subgraph group_plugins["Config Plugins"]
  node_kasane["Kasane Plugin Demo"]
  node_kustomized_helm["Kustomized Helm Plugin<br/>[kustomization.yaml]"]
end

node_operator(("Operator"))
node_argocd{{"Argo CD"}}

node_operator -->|"registers repository"| node_argocd
node_apps -->|"composes and synchronizes"| node_argocd

click node_apps "https://github.com/argoproj/argocd-example-apps/blob/master/apps/templates/applications.yaml"
click node_applicationset "https://github.com/argoproj/argocd-example-apps/tree/master/applicationset"
click node_blue_green "https://github.com/argoproj/argocd-example-apps/blob/master/blue-green/templates/rollout.yaml"
click node_helm_hooks "https://github.com/argoproj/argocd-example-apps/blob/master/helm-hooks/manifests.yaml"
click node_pre_post_sync "https://github.com/argoproj/argocd-example-apps/blob/master/pre-post-sync/kustomization.yaml"
click node_sync_waves "https://github.com/argoproj/argocd-example-apps/blob/master/sync-waves/manifests.yaml"
click node_guestbook "https://github.com/argoproj/argocd-example-apps/blob/master/guestbook/guestbook-ui-deployment.yaml"
click node_helm_dependency "https://github.com/argoproj/argocd-example-apps/blob/master/helm-dependency/Chart.yaml"
click node_helm_guestbook "https://github.com/argoproj/argocd-example-apps/blob/master/helm-guestbook/Chart.yaml"
click node_jsonnet_guestbook "https://github.com/argoproj/argocd-example-apps/blob/master/jsonnet-guestbook/guestbook-ui.jsonnet"
click node_jsonnet_tla "https://github.com/argoproj/argocd-example-apps/blob/master/jsonnet-guestbook-tla/guestbook-ui.jsonnet"
click node_kustomize_guestbook "https://github.com/argoproj/argocd-example-apps/blob/master/kustomize-guestbook/kustomization.yaml"
click node_sock_shop "https://github.com/argoproj/argocd-example-apps/blob/master/sock-shop/kustomization.yaml"
click node_kasane "https://github.com/argoproj/argocd-example-apps/blob/master/plugins/kasane/Kasanefile"
click node_kustomized_helm "https://github.com/argoproj/argocd-example-apps/blob/master/plugins/kustomized-helm/kustomization.yaml"

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_apps toneBlue
class node_applicationset toneAmber
class node_blue_green,node_helm_hooks,node_pre_post_sync,node_sync_waves toneMint
class node_guestbook,node_helm_dependency,node_helm_guestbook,node_jsonnet_guestbook,node_jsonnet_tla,node_kustomize_guestbook,node_sock_shop toneRose
class node_kasane,node_kustomized_helm,node_operator,node_argocd toneIndigo
```

## Components

### App Composition

- [Composed Apps](https://github.com/argoproj/argocd-example-apps/blob/master/apps/templates/applications.yaml): `apps/templates/applications.yaml`

### ApplicationSets

- [Generator Examples](https://github.com/argoproj/argocd-example-apps/tree/master/applicationset): `applicationset`

### Deployment Patterns

- [Blue-Green Rollout](https://github.com/argoproj/argocd-example-apps/blob/master/blue-green/templates/rollout.yaml): `blue-green/templates/rollout.yaml`
- [Helm Hooks](https://github.com/argoproj/argocd-example-apps/blob/master/helm-hooks/manifests.yaml): `helm-hooks/manifests.yaml`
- [Pre/Post Sync](https://github.com/argoproj/argocd-example-apps/blob/master/pre-post-sync/kustomization.yaml): `pre-post-sync/kustomization.yaml`
- [Sync Waves](https://github.com/argoproj/argocd-example-apps/blob/master/sync-waves/manifests.yaml): `sync-waves/manifests.yaml`

### Guestbook Formats

- [Plain YAML Guestbook](https://github.com/argoproj/argocd-example-apps/blob/master/guestbook/guestbook-ui-deployment.yaml): `guestbook/guestbook-ui-deployment.yaml`
- [Upstream Helm Customization](https://github.com/argoproj/argocd-example-apps/blob/master/helm-dependency/Chart.yaml): `helm-dependency/Chart.yaml`
- [Helm Guestbook](https://github.com/argoproj/argocd-example-apps/blob/master/helm-guestbook/Chart.yaml): `helm-guestbook/Chart.yaml`
- [Jsonnet Guestbook](https://github.com/argoproj/argocd-example-apps/blob/master/jsonnet-guestbook/guestbook-ui.jsonnet): `jsonnet-guestbook/guestbook-ui.jsonnet`
- [Jsonnet with Arguments](https://github.com/argoproj/argocd-example-apps/blob/master/jsonnet-guestbook-tla/guestbook-ui.jsonnet): `jsonnet-guestbook-tla/guestbook-ui.jsonnet`
- [Kustomize Guestbook](https://github.com/argoproj/argocd-example-apps/blob/master/kustomize-guestbook/kustomization.yaml): `kustomize-guestbook/kustomization.yaml`
- [Microservices Demo](https://github.com/argoproj/argocd-example-apps/blob/master/sock-shop/kustomization.yaml): `sock-shop/kustomization.yaml`

### Config Plugins

- [Kasane Plugin Demo](https://github.com/argoproj/argocd-example-apps/blob/master/plugins/kasane/Kasanefile): `plugins/kasane/Kasanefile`
- [Kustomized Helm Plugin](https://github.com/argoproj/argocd-example-apps/blob/master/plugins/kustomized-helm/kustomization.yaml): `plugins/kustomized-helm/kustomization.yaml`

### Other components

- **Operator**
- **Argo CD**

## Connections

- Operator → Argo CD: registers repository (evidence: `README.md`)
- Composed Apps → Argo CD: composes and synchronizes (evidence: `README.md`)
