# chalarangelo/30-seconds-of-code architecture

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

- Interactive diagram: https://gitdiagram.com/chalarangelo/30-seconds-of-code
- Repository: https://github.com/chalarangelo/30-seconds-of-code

## Overview

30 Seconds of Code is a coding-article website. Readers search by name, tags, language, or description; browse articles and collections; and open articles containing code and explanations. The tree shows distinct content processing, domain modeling, search, page adaptation, and presentation layers, plus browser-side search UI and code-highlighting extensions. The README establishes reader capabilities, while sampled source confirms selected internal calls. Several runtime connections are not visible in the excerpts, so those links are omitted rather than inferred.

Main entry points: [`src/lib/contentUtils/markdownParser/codeHighlighters/shiki.js`](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/contentUtils/markdownParser/codeHighlighters/shiki.js) (Shiki highlighter), [`src/lib/search/documentSearch.js`](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/search/documentSearch.js) (Search engine), [`src/models/snippet.js`](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/models/snippet.js) (Article model), [`src/adapters/page/snippetPage.js`](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/adapters/page/snippetPage.js) (Article page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Content processing"]
  node_markdown_parser["Markdown parser<br/>[markdownParser.js]"]
  node_shiki["Shiki highlighter<br/>[shiki.js]"]
  node_color_swatches["Color swatches<br/>[colorSwatches.js]"]
  node_line_highlights["Line highlights<br/>[lineHighlights.js]"]
  node_section_folding["Section folding<br/>[sectionFolding.js]"]
end

subgraph group_domain["Article domain"]
  node_snippet_model["Article model<br/>[snippet.js]"]
  node_collection_model["Collection model<br/>[collection.js]"]
  node_language_model["Language model<br/>[language.js]"]
  node_content_model["Content model<br/>[contentModel.js]"]
end

subgraph group_search["Search"]
  node_search_engine["Search engine<br/>[documentSearch.js]"]
  node_search_index[("Document index<br/>[documentIndex.js]")]
  node_tokenizer["Search tokenization<br/>[server.js]"]
end

subgraph group_pages["Page presentation"]
  node_page_adapter["Page adapters<br/>[page.js]"]
  node_snippet_page["Article page<br/>[snippetPage.js]"]
  node_collection_page["Collection page<br/>[collectionPage.js]"]
  node_home_page["Home page<br/>[homePage.js]"]
  node_recommendations["Recommendations"]
  node_breadcrumbs["Breadcrumbs"]
  node_snippet_serializer["Article serializer"]
  node_preview_serializer["Preview serializer"]
end

subgraph group_browser["Browser features"]
  node_search_ui["Search interface<br/>[omnisearch.js]"]
end

node_reader(("Reader"))

node_reader -->|"searches"| node_search_ui
node_search_ui -.->|"requests results"| node_search_engine
node_reader -->|"browses"| node_home_page
node_reader -->|"opens article"| node_snippet_page
node_reader -->|"browses collection"| node_collection_page
node_snippet_model -->|"creates presenter"| node_recommendations
node_snippet_model -->|"creates presenter"| node_breadcrumbs
node_shiki -->|"applies transformer"| node_color_swatches
node_shiki -->|"applies transformer"| node_line_highlights
node_shiki -->|"applies transformer"| node_section_folding
node_markdown_parser -.->|"uses highlighter"| node_shiki
node_search_engine -.->|"queries index"| node_search_index
node_search_engine -.->|"tokenizes query"| node_tokenizer
node_snippet_page -.->|"serializes article"| node_snippet_serializer
node_collection_page -.->|"serializes previews"| node_preview_serializer

click node_search_ui "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/astro/scripts/omnisearch.js"
click node_search_engine "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/search/documentSearch.js"
click node_search_index "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/search/documentIndex.js"
click node_tokenizer "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/search/server.js"
click node_snippet_model "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/models/snippet.js"
click node_collection_model "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/models/collection.js"
click node_language_model "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/models/language.js"
click node_content_model "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/models/contentModel.js"
click node_markdown_parser "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/contentUtils/markdownParser/markdownParser.js"
click node_shiki "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/contentUtils/markdownParser/codeHighlighters/shiki.js"
click node_color_swatches "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/contentUtils/markdownParser/codeHighlighters/transformers/colorSwatches.js"
click node_line_highlights "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/contentUtils/markdownParser/codeHighlighters/transformers/lineHighlights.js"
click node_section_folding "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/contentUtils/markdownParser/codeHighlighters/transformers/sectionFolding.js"
click node_page_adapter "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/adapters/page.js"
click node_snippet_page "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/adapters/page/snippetPage.js"
click node_collection_page "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/adapters/page/collectionPage.js"
click node_home_page "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/adapters/page/homePage.js"
click node_recommendations "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/presenters/recommendationPresenter.js"
click node_breadcrumbs "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/presenters/breadcrumbPresenter.js"
click node_snippet_serializer "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/serializers/snippetContextSerializer.js"
click node_preview_serializer "https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/serializers/previewSerializer.js"

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_markdown_parser,node_shiki,node_color_swatches,node_line_highlights,node_section_folding toneBlue
class node_snippet_model,node_collection_model,node_language_model,node_content_model toneAmber
class node_search_engine,node_search_index,node_tokenizer toneMint
class node_page_adapter,node_snippet_page,node_collection_page,node_home_page,node_recommendations,node_breadcrumbs,node_snippet_serializer,node_preview_serializer toneRose
class node_search_ui,node_reader toneIndigo
```

## Components

### Content processing

- [Markdown parser](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/contentUtils/markdownParser/markdownParser.js): `src/lib/contentUtils/markdownParser/markdownParser.js`
- [Shiki highlighter](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/contentUtils/markdownParser/codeHighlighters/shiki.js): `src/lib/contentUtils/markdownParser/codeHighlighters/shiki.js`
- [Color swatches](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/contentUtils/markdownParser/codeHighlighters/transformers/colorSwatches.js): `src/lib/contentUtils/markdownParser/codeHighlighters/transformers/colorSwatches.js`
- [Line highlights](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/contentUtils/markdownParser/codeHighlighters/transformers/lineHighlights.js): `src/lib/contentUtils/markdownParser/codeHighlighters/transformers/lineHighlights.js`
- [Section folding](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/contentUtils/markdownParser/codeHighlighters/transformers/sectionFolding.js): `src/lib/contentUtils/markdownParser/codeHighlighters/transformers/sectionFolding.js`

### Article domain

- [Article model](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/models/snippet.js): `src/models/snippet.js`
- [Collection model](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/models/collection.js): `src/models/collection.js`
- [Language model](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/models/language.js): `src/models/language.js`
- [Content model](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/models/contentModel.js): `src/models/contentModel.js`

### Search

- [Search engine](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/search/documentSearch.js): `src/lib/search/documentSearch.js`
- [Document index](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/search/documentIndex.js): `src/lib/search/documentIndex.js`
- [Search tokenization](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/lib/search/server.js): `src/lib/search/server.js`

### Page presentation

- [Page adapters](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/adapters/page.js): `src/adapters/page.js`
- [Article page](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/adapters/page/snippetPage.js): `src/adapters/page/snippetPage.js`
- [Collection page](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/adapters/page/collectionPage.js): `src/adapters/page/collectionPage.js`
- [Home page](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/adapters/page/homePage.js): `src/adapters/page/homePage.js`
- [Recommendations](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/presenters/recommendationPresenter.js): `src/presenters/recommendationPresenter.js`
- [Breadcrumbs](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/presenters/breadcrumbPresenter.js): `src/presenters/breadcrumbPresenter.js`
- [Article serializer](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/serializers/snippetContextSerializer.js): `src/serializers/snippetContextSerializer.js`
- [Preview serializer](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/serializers/previewSerializer.js): `src/serializers/previewSerializer.js`

### Browser features

- [Search interface](https://github.com/chalarangelo/30-seconds-of-code/blob/master/src/astro/scripts/omnisearch.js): `src/astro/scripts/omnisearch.js`

### Other components

- **Reader**

## Connections

- Reader → Search interface: searches (evidence: `README.md`)
- Search interface → Search engine: requests results
- Reader → Home page: browses (evidence: `README.md`)
- Reader → Article page: opens article (evidence: `README.md`)
- Reader → Collection page: browses collection (evidence: `README.md`)
- Article model → Recommendations: creates presenter (evidence: `src/models/snippet.js`)
- Article model → Breadcrumbs: creates presenter (evidence: `src/models/snippet.js`)
- Shiki highlighter → Color swatches: applies transformer (evidence: `src/lib/contentUtils/markdownParser/codeHighlighters/shiki.js`)
- Shiki highlighter → Line highlights: applies transformer (evidence: `src/lib/contentUtils/markdownParser/codeHighlighters/shiki.js`)
- Shiki highlighter → Section folding: applies transformer (evidence: `src/lib/contentUtils/markdownParser/codeHighlighters/shiki.js`)
- Markdown parser → Shiki highlighter: uses highlighter
- Search engine → Document index: queries index
- Search engine → Search tokenization: tokenizes query
- Article page → Article serializer: serializes article
- Collection page → Preview serializer: serializes previews
