# layer5io/layer5-academy architecture

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

- Interactive diagram: https://gitdiagram.com/layer5io/layer5-academy
- Repository: https://github.com/layer5io/layer5-academy

## Overview

Layer5 Academy is a content repository: authors create learning materials in Markdown, which the Hugo-based Academy site renders for learners and the wider Academy platform. The main content branches are learning paths, challenges, certifications, and authoring examples; embedded Meshery designs are another learner-facing capability. The README documents assessment conversion by the external Academy theme and integration with academy-build. Sampled source confirms Cytoscape rendering for embedded designs; other runtime wiring is summarized only where documented.

Main entry points: [`content/learning-paths`](https://github.com/layer5io/layer5-academy/tree/master/content/learning-paths) (Learning paths), [`content/challenges`](https://github.com/layer5io/layer5-academy/tree/master/content/challenges) (Challenges), [`content/certifications`](https://github.com/layer5io/layer5-academy/tree/master/content/certifications) (Certifications), [`content/content-formatting-examples`](https://github.com/layer5io/layer5-academy/tree/master/content/content-formatting-examples) (Formatting examples)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Learning content"]
  node_learning["Learning paths"]
  node_challenges["Challenges"]
  node_certifications["Certifications"]
  node_examples["Formatting examples"]
  node_designs["Embedded designs"]
end

subgraph group_rendering["Site rendering"]
  node_hugo["Hugo site"]
  node_theme["Academy theme"]
  node_cytoscape["Design renderer"]
  node_rendered["Rendered Academy content"]
end

subgraph group_platform["Academy platform"]
  node_build["academy-build"]
  node_cloud["Layer5 Cloud"]
end

node_author(("Content author"))
node_learner(("Learner"))

node_author -->|"authors"| node_learning
node_author -->|"authors"| node_challenges
node_author -->|"authors"| node_certifications
node_author -->|"authors"| node_examples
node_learning -->|"provides content"| node_hugo
node_challenges -->|"provides content"| node_hugo
node_certifications -->|"provides content"| node_hugo
node_examples -->|"provides content"| node_hugo
node_hugo -->|"uses"| node_theme
node_theme -->|"renders"| node_rendered
node_theme -->|"converts assessments"| node_cloud
node_designs -->|"renders design"| node_cytoscape
node_cytoscape -->|"displays"| node_rendered
node_rendered -->|"aggregated by"| node_build
node_build -->|"publishes to"| node_cloud
node_learner -->|"views content"| node_cloud

click node_learning "https://github.com/layer5io/layer5-academy/tree/master/content/learning-paths"
click node_challenges "https://github.com/layer5io/layer5-academy/tree/master/content/challenges"
click node_certifications "https://github.com/layer5io/layer5-academy/tree/master/content/certifications"
click node_examples "https://github.com/layer5io/layer5-academy/tree/master/content/content-formatting-examples"
click node_designs "https://github.com/layer5io/layer5-academy/tree/master/content/learning-paths/d011fd20-a3f5-4480-883b-dfb34321d168/mastering-kubernetes-for-engineers/explore-dapr-with-meshery"

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_learning,node_challenges,node_certifications,node_examples,node_designs toneBlue
class node_hugo,node_theme,node_cytoscape,node_rendered toneAmber
class node_build,node_cloud toneMint
class node_author,node_learner toneIndigo
```

## Components

### Learning content

- [Learning paths](https://github.com/layer5io/layer5-academy/tree/master/content/learning-paths): `content/learning-paths`
- [Challenges](https://github.com/layer5io/layer5-academy/tree/master/content/challenges): `content/challenges`
- [Certifications](https://github.com/layer5io/layer5-academy/tree/master/content/certifications): `content/certifications`
- [Formatting examples](https://github.com/layer5io/layer5-academy/tree/master/content/content-formatting-examples): `content/content-formatting-examples`
- [Embedded designs](https://github.com/layer5io/layer5-academy/tree/master/content/learning-paths/d011fd20-a3f5-4480-883b-dfb34321d168/mastering-kubernetes-for-engineers/explore-dapr-with-meshery): `content/learning-paths/d011fd20-a3f5-4480-883b-dfb34321d168/mastering-kubernetes-for-engineers/explore-dapr-with-meshery`

### Site rendering

- **Hugo site**
- **Academy theme**
- **Design renderer**
- **Rendered Academy content**

### Academy platform

- **academy-build**
- **Layer5 Cloud**

### Other components

- **Content author**
- **Learner**

## Connections

- Content author → Learning paths: authors
- Content author → Challenges: authors
- Content author → Certifications: authors
- Content author → Formatting examples: authors
- Learning paths → Hugo site: provides content
- Challenges → Hugo site: provides content
- Certifications → Hugo site: provides content
- Formatting examples → Hugo site: provides content
- Hugo site → Academy theme: uses
- Academy theme → Rendered Academy content: renders
- Academy theme → Layer5 Cloud: converts assessments
- Embedded designs → Design renderer: renders design
- Design renderer → Rendered Academy content: displays
- Rendered Academy content → academy-build: aggregated by
- academy-build → Layer5 Cloud: publishes to
- Learner → Layer5 Cloud: views content