# workday/workdaydeveloperprogram architecture

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

## Overview

This repository is a Workday Build example hub: its primary result is helping developers discover, copy, and adapt sample apps and other reusable artifacts. The optional gallery indexes example metadata and offers per-example downloads; examples can also be used directly from the repository. Contribution quality is supported by validation and auditing tools that produce reports for contributors and pull requests. The graph reflects documented capabilities and shown source references; many catalog implementations are declarative Workday artifacts, and their internal runtime interactions are not established by the excerpts.

Main entry points: [`catalog`](https://github.com/workday/workdaydeveloperprogram/tree/main/catalog) (Workday catalog), [`scripts/audit-examples.mjs`](https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit-examples.mjs) (Audit runner), [`site/src/lib/examples.js`](https://github.com/workday/workdaydeveloperprogram/blob/main/site/src/lib/examples.js) (Gallery), [`scripts/audit/post-review.mjs`](https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit/post-review.mjs) (Pull request feedback)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_library["Example library"]
  node_catalog["Workday catalog"]
  node_extend["Extend apps"]
  node_integrations["Integration examples"]
  node_orchestration["Orchestration examples"]
  node_references["Reference material"]
end

subgraph group_gallery["Optional gallery"]
  node_gallery["Gallery<br/>[examples.js]"]
  node_zipbuild["Download packaging<br/>[build-zips.mjs]"]
  node_gittrace["Source trace<br/>[gitTrace.js]"]
end

subgraph group_quality["Contribution quality"]
  node_validator["Example validator"]
end

subgraph group_audit["Audit reporting"]
  node_auditor["Audit runner<br/>[audit-examples.mjs]"]
  node_arcane["Arcane adapter<br/>[arcane.mjs]"]
  node_hubrules["Hub rules<br/>[hub-rules.mjs]"]
  node_diff["Change analysis<br/>[diff.mjs]"]
  node_report["Report policy<br/>[report.mjs]"]
  node_render["Report rendering<br/>[render.mjs]"]
  node_prreview["Pull request feedback<br/>[post-review.mjs]"]
end

node_developer(("Developer"))
node_github(("GitHub pull request"))

node_developer -->|"browses or copies"| node_catalog
node_catalog -->|"includes"| node_extend
node_catalog -->|"includes"| node_integrations
node_catalog -->|"includes"| node_orchestration
node_catalog -->|"includes"| node_references
node_developer -->|"browses"| node_gallery
node_gallery -->|"indexes metadata"| node_catalog
node_gallery -->|"creates checkout guidance"| node_gittrace
node_gallery -->|"offers downloads"| node_zipbuild
node_zipbuild -->|"writes source notes"| node_gittrace
node_developer -->|"validates contributions"| node_validator
node_auditor -->|"finds changed examples"| node_diff
node_auditor -->|"runs or loads audit"| node_arcane
node_auditor -.->|"applies hub rules"| node_hubrules
node_hubrules -->|"validates entries"| node_validator
node_auditor -.->|"builds unified report"| node_report
node_auditor -->|"renders output"| node_render
node_render -->|"uses suggestions"| node_report
node_github -.->|"triggers feedback"| node_prreview
node_prreview -->|"formats findings"| node_report
node_prreview -->|"posts review comments"| node_github

click node_catalog "https://github.com/workday/workdaydeveloperprogram/tree/main/catalog"
click node_extend "https://github.com/workday/workdaydeveloperprogram/tree/main/catalog"
click node_integrations "https://github.com/workday/workdaydeveloperprogram/tree/main/catalog"
click node_orchestration "https://github.com/workday/workdaydeveloperprogram/tree/main/catalog"
click node_references "https://github.com/workday/workdaydeveloperprogram/tree/main/catalog"
click node_gallery "https://github.com/workday/workdaydeveloperprogram/blob/main/site/src/lib/examples.js"
click node_zipbuild "https://github.com/workday/workdaydeveloperprogram/blob/main/site/scripts/build-zips.mjs"
click node_gittrace "https://github.com/workday/workdaydeveloperprogram/blob/main/site/src/lib/gitTrace.js"
click node_validator "https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/validate-examples.mjs"
click node_auditor "https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit-examples.mjs"
click node_arcane "https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit/arcane.mjs"
click node_hubrules "https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit/hub-rules.mjs"
click node_diff "https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit/diff.mjs"
click node_report "https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit/report.mjs"
click node_render "https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit/render.mjs"
click node_prreview "https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit/post-review.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_catalog,node_extend,node_integrations,node_orchestration,node_references toneBlue
class node_gallery,node_zipbuild,node_gittrace toneAmber
class node_validator,node_github toneMint
class node_auditor,node_arcane,node_hubrules,node_diff,node_report,node_render,node_prreview toneRose
class node_developer toneIndigo
```

## Components

### Example library

- [Workday catalog](https://github.com/workday/workdaydeveloperprogram/tree/main/catalog): `catalog`
- [Extend apps](https://github.com/workday/workdaydeveloperprogram/tree/main/catalog): `catalog`
- [Integration examples](https://github.com/workday/workdaydeveloperprogram/tree/main/catalog): `catalog`
- [Orchestration examples](https://github.com/workday/workdaydeveloperprogram/tree/main/catalog): `catalog`
- [Reference material](https://github.com/workday/workdaydeveloperprogram/tree/main/catalog): `catalog`

### Optional gallery

- [Gallery](https://github.com/workday/workdaydeveloperprogram/blob/main/site/src/lib/examples.js): `site/src/lib/examples.js`
- [Download packaging](https://github.com/workday/workdaydeveloperprogram/blob/main/site/scripts/build-zips.mjs): `site/scripts/build-zips.mjs`
- [Source trace](https://github.com/workday/workdaydeveloperprogram/blob/main/site/src/lib/gitTrace.js): `site/src/lib/gitTrace.js`

### Contribution quality

- [Example validator](https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/validate-examples.mjs): `scripts/validate-examples.mjs`

### Audit reporting

- [Audit runner](https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit-examples.mjs): `scripts/audit-examples.mjs`
- [Arcane adapter](https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit/arcane.mjs): `scripts/audit/arcane.mjs`
- [Hub rules](https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit/hub-rules.mjs): `scripts/audit/hub-rules.mjs`
- [Change analysis](https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit/diff.mjs): `scripts/audit/diff.mjs`
- [Report policy](https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit/report.mjs): `scripts/audit/report.mjs`
- [Report rendering](https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit/render.mjs): `scripts/audit/render.mjs`
- [Pull request feedback](https://github.com/workday/workdaydeveloperprogram/blob/main/scripts/audit/post-review.mjs): `scripts/audit/post-review.mjs`

### Other components

- **Developer**
- **GitHub pull request**

## Connections

- Developer → Workday catalog: browses or copies (evidence: `README.md`)
- Workday catalog → Extend apps: includes (evidence: `README.md`)
- Workday catalog → Integration examples: includes (evidence: `README.md`)
- Workday catalog → Orchestration examples: includes (evidence: `README.md`)
- Workday catalog → Reference material: includes (evidence: `README.md`)
- Developer → Gallery: browses (evidence: `README.md`)
- Gallery → Workday catalog: indexes metadata (evidence: `site/src/lib/examples.js`)
- Gallery → Source trace: creates checkout guidance (evidence: `site/src/lib/examples.js`)
- Gallery → Download packaging: offers downloads (evidence: `README.md`)
- Download packaging → Source trace: writes source notes (evidence: `site/scripts/build-zips.mjs`)
- Developer → Example validator: validates contributions (evidence: `README.md`)
- Audit runner → Change analysis: finds changed examples (evidence: `scripts/audit-examples.mjs`)
- Audit runner → Arcane adapter: runs or loads audit (evidence: `scripts/audit-examples.mjs`)
- Audit runner → Hub rules: applies hub rules (evidence: `scripts/audit-examples.mjs`)
- Hub rules → Example validator: validates entries (evidence: `scripts/audit/hub-rules.mjs`)
- Audit runner → Report policy: builds unified report (evidence: `scripts/audit-examples.mjs`)
- Audit runner → Report rendering: renders output (evidence: `scripts/audit-examples.mjs`)
- Report rendering → Report policy: uses suggestions (evidence: `scripts/audit/render.mjs`)
- GitHub pull request → Pull request feedback: triggers feedback
- Pull request feedback → Report policy: formats findings (evidence: `scripts/audit/post-review.mjs`)
- Pull request feedback → GitHub pull request: posts review comments (evidence: `scripts/audit/post-review.mjs`)
