External sources

All external dependencies used by the docs site — container images, Hugo modules, Go libraries, and services.

Container images

Used in compose/compose.yaml, CI workflows, and Dockerfiles.

ImageUsed byPurpose
golang:1.26-alpinecompose/docs-builder/Dockerfile (build stage)Compiles Go CLI tools
hugomods/hugo:base-0.160.0compose/docs-builder/Dockerfile (runtime stage)Hugo extended — static site generator
caddy:2.9.1-alpinecompose/compose.yaml, TiltfileServes the built site locally and in dev clusters
yuzutech/kroki:0.30.1compose/compose.yaml (kroki)Diagram rendering gateway (kroki.io)
yuzutech/kroki-mermaid:0.30.1compose/compose.yaml (mermaid)Mermaid diagram renderer for Kroki

Hugo modules

Vendored under _vendor/. Managed via go.mod and config/hugo.toml.

ModuleVersionPurpose
McShelby/hugo-theme-relearn93d7f257d1a3Site theme — docs
hugomods/krokiv0.2.1Hugo integration for Kroki diagram code blocks — docs

Go dependencies

From go.mod (module kode.dataverket.org/docs-builder):

ModulePurpose
xeipuuv/gojsonschemaJSON Schema validation in smadr-validator
gopkg.in/yaml.v3YAML parsing for config files and ADR frontmatter

Services

Runtime services used during the build and when serving locally.

ServiceRoleConfig
KrokiRenders diagram code blocks (PlantUML, Mermaid, D2, etc.) to inline SVGconfig/hugo.toml [params.kroki], compose/compose.yaml
MermaidKroki companion for Mermaid diagramsStarted alongside Kroki via compose/compose.yaml
CaddyServes the static site with gzip/zstd compressionconfig/Caddyfile

CI infrastructure

ComponentPurpose
Forgejo ActionsCI runner (.forgejo/workflows/)
BuildahOCI image builds in CI (rootless, no Docker socket)
GrypeContainer vulnerability scanning (docs-container-scan.yaml)
SyftSBOM generation for scanned images

Hosting

PlatformPurpose
CodebergGit hosting, container registry, CI runners
Codeberg PagesStatic site hosting via the pages repo