# bogdanp/awesome-advent-of-code architecture

> Architecture diagram of the GitHub repository bogdanp/awesome-advent-of-code, 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/bogdanp/awesome-advent-of-code
- Repository: https://github.com/bogdanp/awesome-advent-of-code

## Overview

Awesome Advent of Code is a curated resource catalog, not an application runtime. Visitors use the README to find project templates, tools, community links, and yearly solution collections; year-specific files hold the earlier collections. The README also presents 2025 solutions and live-stream navigation. The supplied README excerpt ends during Tools and Utilities, and no source excerpts were provided, so the graph shows only documented navigation and capabilities, not the contents or internal relationships of those resources.

Main entry points: [`README.md`](https://github.com/bogdanp/awesome-advent-of-code/blob/master/README.md) (Resource Index), [`2018.md`](https://github.com/bogdanp/awesome-advent-of-code/blob/master/2018.md) (2018 Collection), [`2019.md`](https://github.com/bogdanp/awesome-advent-of-code/blob/master/2019.md) (2019 Collection), [`2020.md`](https://github.com/bogdanp/awesome-advent-of-code/blob/master/2020.md) (2020 Collection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Resource Catalog"]
  node_catalog_home["Resource Index<br/>[README.md]"]
  node_templates["Project Templates<br/>[README.md]"]
  node_tools["Tools and Utilities<br/>[README.md]"]
  node_other_calendars["Other Calendars<br/>[README.md]"]
  node_live_streams["Live Streams<br/>[README.md]"]
  node_community["AoC Community<br/>[README.md]"]
end

subgraph group_archives["Yearly Collections"]
  node_y2018["2018 Collection<br/>[2018.md]"]
  node_y2019["2019 Collection<br/>[2019.md]"]
  node_y2020["2020 Collection<br/>[2020.md]"]
  node_y2021["2021 Collection<br/>[2021.md]"]
  node_y2022["2022 Collection<br/>[2022.md]"]
  node_y2023["2023 Collection<br/>[2023.md]"]
  node_y2024["2024 Collection<br/>[2024.md]"]
  node_y2025["2025 Solutions<br/>[README.md]"]
end

node_visitor(("Visitor"))
node_official_aoc["Official AoC"]
node_subreddit["AoC Subreddit"]

node_visitor -->|"browses"| node_catalog_home
node_catalog_home -->|"indexes"| node_templates
node_catalog_home -->|"indexes"| node_tools
node_catalog_home -->|"indexes"| node_other_calendars
node_catalog_home -->|"indexes"| node_live_streams
node_catalog_home -->|"links"| node_community
node_catalog_home -->|"links"| node_y2018
node_catalog_home -->|"links"| node_y2019
node_catalog_home -->|"links"| node_y2020
node_catalog_home -->|"links"| node_y2021
node_catalog_home -->|"links"| node_y2022
node_catalog_home -->|"links"| node_y2023
node_catalog_home -->|"links"| node_y2024
node_catalog_home -->|"links"| node_y2025
node_community -->|"links"| node_official_aoc
node_community -->|"links"| node_subreddit

click node_catalog_home "https://github.com/bogdanp/awesome-advent-of-code/blob/master/README.md"
click node_templates "https://github.com/bogdanp/awesome-advent-of-code/blob/master/README.md"
click node_tools "https://github.com/bogdanp/awesome-advent-of-code/blob/master/README.md"
click node_other_calendars "https://github.com/bogdanp/awesome-advent-of-code/blob/master/README.md"
click node_live_streams "https://github.com/bogdanp/awesome-advent-of-code/blob/master/README.md"
click node_community "https://github.com/bogdanp/awesome-advent-of-code/blob/master/README.md"
click node_y2018 "https://github.com/bogdanp/awesome-advent-of-code/blob/master/2018.md"
click node_y2019 "https://github.com/bogdanp/awesome-advent-of-code/blob/master/2019.md"
click node_y2020 "https://github.com/bogdanp/awesome-advent-of-code/blob/master/2020.md"
click node_y2021 "https://github.com/bogdanp/awesome-advent-of-code/blob/master/2021.md"
click node_y2022 "https://github.com/bogdanp/awesome-advent-of-code/blob/master/2022.md"
click node_y2023 "https://github.com/bogdanp/awesome-advent-of-code/blob/master/2023.md"
click node_y2024 "https://github.com/bogdanp/awesome-advent-of-code/blob/master/2024.md"
click node_y2025 "https://github.com/bogdanp/awesome-advent-of-code/blob/master/README.md"

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_home,node_templates,node_tools,node_other_calendars,node_live_streams,node_community toneBlue
class node_y2018,node_y2019,node_y2020,node_y2021,node_y2022,node_y2023,node_y2024,node_y2025 toneAmber
class node_visitor,node_official_aoc,node_subreddit toneIndigo
```

## Components

### Resource Catalog

- [Resource Index](https://github.com/bogdanp/awesome-advent-of-code/blob/master/README.md): `README.md`
- [Project Templates](https://github.com/bogdanp/awesome-advent-of-code/blob/master/README.md): `README.md`
- [Tools and Utilities](https://github.com/bogdanp/awesome-advent-of-code/blob/master/README.md): `README.md`
- [Other Calendars](https://github.com/bogdanp/awesome-advent-of-code/blob/master/README.md): `README.md`
- [Live Streams](https://github.com/bogdanp/awesome-advent-of-code/blob/master/README.md): `README.md`
- [AoC Community](https://github.com/bogdanp/awesome-advent-of-code/blob/master/README.md): `README.md`

### Yearly Collections

- [2018 Collection](https://github.com/bogdanp/awesome-advent-of-code/blob/master/2018.md): `2018.md`
- [2019 Collection](https://github.com/bogdanp/awesome-advent-of-code/blob/master/2019.md): `2019.md`
- [2020 Collection](https://github.com/bogdanp/awesome-advent-of-code/blob/master/2020.md): `2020.md`
- [2021 Collection](https://github.com/bogdanp/awesome-advent-of-code/blob/master/2021.md): `2021.md`
- [2022 Collection](https://github.com/bogdanp/awesome-advent-of-code/blob/master/2022.md): `2022.md`
- [2023 Collection](https://github.com/bogdanp/awesome-advent-of-code/blob/master/2023.md): `2023.md`
- [2024 Collection](https://github.com/bogdanp/awesome-advent-of-code/blob/master/2024.md): `2024.md`
- [2025 Solutions](https://github.com/bogdanp/awesome-advent-of-code/blob/master/README.md): `README.md`

### Other components

- **Visitor**
- **Official AoC**
- **AoC Subreddit**

## Connections

- Visitor → Resource Index: browses (evidence: `README.md`)
- Resource Index → Project Templates: indexes (evidence: `README.md`)
- Resource Index → Tools and Utilities: indexes (evidence: `README.md`)
- Resource Index → Other Calendars: indexes (evidence: `README.md`)
- Resource Index → Live Streams: indexes (evidence: `README.md`)
- Resource Index → AoC Community: links (evidence: `README.md`)
- Resource Index → 2018 Collection: links (evidence: `README.md`)
- Resource Index → 2019 Collection: links (evidence: `README.md`)
- Resource Index → 2020 Collection: links (evidence: `README.md`)
- Resource Index → 2021 Collection: links (evidence: `README.md`)
- Resource Index → 2022 Collection: links (evidence: `README.md`)
- Resource Index → 2023 Collection: links (evidence: `README.md`)
- Resource Index → 2024 Collection: links (evidence: `README.md`)
- Resource Index → 2025 Solutions: links (evidence: `README.md`)
- AoC Community → Official AoC: links (evidence: `README.md`)
- AoC Community → AoC Subreddit: links (evidence: `README.md`)
