# crabston/grav-skeleton-hadron architecture

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

- Interactive diagram: https://gitdiagram.com/crabston/grav-skeleton-hadron
- Repository: https://github.com/crabston/grav-skeleton-hadron

## Overview

This repository is a Grav CMS Hadron skeleton: a ready-to-use multilingual website foundation, with example content, theme configuration, plugins, and optional commerce/form capabilities. The main user workflow is to browse rendered site pages; site administrators configure the foundation and build on its examples. The tree and README document these areas, but the only sampled runtime source is the custom theme adapter, so runtime relationships between Grav, plugins, and theme components are not asserted.

Main entry points: [`pages/03.templates`](https://github.com/crabston/grav-skeleton-hadron/tree/main/pages/03.templates) (Template examples), [`themes/custom/custom.php`](https://github.com/crabston/grav-skeleton-hadron/blob/main/themes/custom/custom.php) (Custom theme adapter), [`pages/03.templates/05.shop`](https://github.com/crabston/grav-skeleton-hadron/tree/main/pages/03.templates/05.shop) (Shop pages), [`config/plugins/snipcart.yaml`](https://github.com/crabston/grav-skeleton-hadron/blob/main/config/plugins/snipcart.yaml) (Snipcart integration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site Content"]
  node_page_examples["Page examples"]
  node_page_templates["Template examples<br/>[03.templates]"]
  node_docs["Documentation pages<br/>[06.docs]"]
end

subgraph group_platform["Grav Configuration"]
  node_site_config["Site settings<br/>[site.yaml]"]
  node_system_config["System settings<br/>[system.yaml]"]
  node_access_groups["Access groups<br/>[groups.yaml]"]
  node_plugin_config["Plugin configuration"]
end

subgraph group_theme["Theme Extension"]
  node_theme_custom["Custom theme adapter<br/>[custom.php]"]
  node_theme_styles["Theme styles"]
  node_theme_scripts["Theme scripts<br/>[custom.ts]"]
end

subgraph group_plugins["Site Capabilities"]
  node_blog["Blog publishing<br/>[archives.yaml]"]
  node_search["Site search<br/>[tntsearch.yaml]"]
  node_forms["Forms<br/>[form.yaml]"]
  node_commerce["Shop pages<br/>[05.shop]"]
  node_snipcart["Snipcart integration<br/>[snipcart.yaml]"]
  node_seo["SEO and feeds<br/>[autoseo.yaml]"]
  node_media["Media handling<br/>[media.yaml]"]
end

node_visitor(("Site visitor"))
node_administrator(("Site administrator"))
node_grav["Grav CMS"]
node_external_services["External services"]

node_administrator -->|"configures"| node_site_config
node_administrator -->|"adapts examples"| node_page_examples
node_visitor -.->|"requests pages"| node_grav
node_grav -.->|"renders content"| node_page_examples
node_grav -.->|"uses examples"| node_page_templates
node_grav -.->|"renders docs"| node_docs
node_administrator -->|"manages permissions"| node_access_groups
node_administrator -->|"configures features"| node_plugin_config
node_grav -.->|"loads theme"| node_theme_custom
node_theme_custom -->|"registers Twig path"| node_grav
node_page_templates -.->|"demonstrates publishing"| node_blog
node_page_templates -.->|"demonstrates forms"| node_forms
node_page_templates -->|"demonstrates shop"| node_commerce
node_commerce -.->|"uses commerce config"| node_snipcart
node_grav -.->|"provides search"| node_search
node_grav -.->|"provides publishing features"| node_seo
node_grav -.->|"handles media"| node_media
node_theme_styles -.->|"customizes appearance"| node_theme_custom
node_theme_scripts -.->|"customizes behavior"| node_theme_custom
node_snipcart -.->|"connects commerce"| node_external_services
node_grav -.->|"uses settings"| node_system_config

click node_page_examples "https://github.com/crabston/grav-skeleton-hadron/tree/main/pages"
click node_page_templates "https://github.com/crabston/grav-skeleton-hadron/tree/main/pages/03.templates"
click node_docs "https://github.com/crabston/grav-skeleton-hadron/tree/main/pages/06.docs"
click node_site_config "https://github.com/crabston/grav-skeleton-hadron/blob/main/config/site.yaml"
click node_system_config "https://github.com/crabston/grav-skeleton-hadron/blob/main/config/system.yaml"
click node_access_groups "https://github.com/crabston/grav-skeleton-hadron/blob/main/config/groups.yaml"
click node_plugin_config "https://github.com/crabston/grav-skeleton-hadron/tree/main/config/plugins"
click node_theme_custom "https://github.com/crabston/grav-skeleton-hadron/blob/main/themes/custom/custom.php"
click node_theme_styles "https://github.com/crabston/grav-skeleton-hadron/tree/main/themes/custom/scss"
click node_theme_scripts "https://github.com/crabston/grav-skeleton-hadron/blob/main/themes/custom/ts/custom.ts"
click node_blog "https://github.com/crabston/grav-skeleton-hadron/blob/main/config/plugins/archives.yaml"
click node_search "https://github.com/crabston/grav-skeleton-hadron/blob/main/config/plugins/tntsearch.yaml"
click node_forms "https://github.com/crabston/grav-skeleton-hadron/blob/main/config/plugins/form.yaml"
click node_commerce "https://github.com/crabston/grav-skeleton-hadron/tree/main/pages/03.templates/05.shop"
click node_snipcart "https://github.com/crabston/grav-skeleton-hadron/blob/main/config/plugins/snipcart.yaml"
click node_seo "https://github.com/crabston/grav-skeleton-hadron/blob/main/config/plugins/autoseo.yaml"
click node_media "https://github.com/crabston/grav-skeleton-hadron/blob/main/config/media.yaml"

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_page_examples,node_page_templates,node_docs toneBlue
class node_site_config,node_system_config,node_access_groups,node_plugin_config toneAmber
class node_theme_custom,node_theme_styles,node_theme_scripts toneMint
class node_blog,node_search,node_forms,node_commerce,node_snipcart,node_seo,node_media toneRose
class node_visitor,node_administrator,node_grav,node_external_services toneIndigo
```

## Components

### Site Content

- [Page examples](https://github.com/crabston/grav-skeleton-hadron/tree/main/pages): `pages`
- [Template examples](https://github.com/crabston/grav-skeleton-hadron/tree/main/pages/03.templates): `pages/03.templates`
- [Documentation pages](https://github.com/crabston/grav-skeleton-hadron/tree/main/pages/06.docs): `pages/06.docs`

### Grav Configuration

- [Site settings](https://github.com/crabston/grav-skeleton-hadron/blob/main/config/site.yaml): `config/site.yaml`
- [System settings](https://github.com/crabston/grav-skeleton-hadron/blob/main/config/system.yaml): `config/system.yaml`
- [Access groups](https://github.com/crabston/grav-skeleton-hadron/blob/main/config/groups.yaml): `config/groups.yaml`
- [Plugin configuration](https://github.com/crabston/grav-skeleton-hadron/tree/main/config/plugins): `config/plugins`

### Theme Extension

- [Custom theme adapter](https://github.com/crabston/grav-skeleton-hadron/blob/main/themes/custom/custom.php): `themes/custom/custom.php`
- [Theme styles](https://github.com/crabston/grav-skeleton-hadron/tree/main/themes/custom/scss): `themes/custom/scss`
- [Theme scripts](https://github.com/crabston/grav-skeleton-hadron/blob/main/themes/custom/ts/custom.ts): `themes/custom/ts/custom.ts`

### Site Capabilities

- [Blog publishing](https://github.com/crabston/grav-skeleton-hadron/blob/main/config/plugins/archives.yaml): `config/plugins/archives.yaml`
- [Site search](https://github.com/crabston/grav-skeleton-hadron/blob/main/config/plugins/tntsearch.yaml): `config/plugins/tntsearch.yaml`
- [Forms](https://github.com/crabston/grav-skeleton-hadron/blob/main/config/plugins/form.yaml): `config/plugins/form.yaml`
- [Shop pages](https://github.com/crabston/grav-skeleton-hadron/tree/main/pages/03.templates/05.shop): `pages/03.templates/05.shop`
- [Snipcart integration](https://github.com/crabston/grav-skeleton-hadron/blob/main/config/plugins/snipcart.yaml): `config/plugins/snipcart.yaml`
- [SEO and feeds](https://github.com/crabston/grav-skeleton-hadron/blob/main/config/plugins/autoseo.yaml): `config/plugins/autoseo.yaml`
- [Media handling](https://github.com/crabston/grav-skeleton-hadron/blob/main/config/media.yaml): `config/media.yaml`

### Other components

- **Site visitor**
- **Site administrator**
- **Grav CMS**
- **External services**

## Connections

- Site administrator → Site settings: configures (evidence: `README.md`)
- Site administrator → Page examples: adapts examples (evidence: `README.md`)
- Site visitor → Grav CMS: requests pages
- Grav CMS → Page examples: renders content
- Grav CMS → Template examples: uses examples
- Grav CMS → Documentation pages: renders docs
- Site administrator → Access groups: manages permissions (evidence: `README.md`)
- Site administrator → Plugin configuration: configures features (evidence: `README.md`)
- Grav CMS → Custom theme adapter: loads theme
- Custom theme adapter → Grav CMS: registers Twig path (evidence: `themes/custom/custom.php`)
- Template examples → Blog publishing: demonstrates publishing
- Template examples → Forms: demonstrates forms
- Template examples → Shop pages: demonstrates shop (evidence: `README.md`)
- Shop pages → Snipcart integration: uses commerce config
- Grav CMS → Site search: provides search
- Grav CMS → SEO and feeds: provides publishing features
- Grav CMS → Media handling: handles media
- Theme styles → Custom theme adapter: customizes appearance
- Theme scripts → Custom theme adapter: customizes behavior
- Snipcart integration → External services: connects commerce
- Grav CMS → System settings: uses settings
