# kitelloran/hp-asean architecture

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

- Interactive diagram: https://gitdiagram.com/kitelloran/hp-asean
- Repository: https://github.com/kitelloran/hp-asean

## Overview

This repository is a Jekyll-hosted ASEAN biodiversity portal built around GBIF’s hosted-portal theme and biodiversity widgets. Visitors can explore occurrence and literature searches, collections, institutions, and taxonomy, alongside informational and resource pages; the configuration exposes these search routes, while a home-page script retrieves occurrence statistics from GBIF GraphQL. The tree indicates additional domain pages, but their runtime wiring is not shown. The graph therefore connects only relationships supported by the README or sampled source.

Main entry points: [`_includes/js/config.js`](https://github.com/kitelloran/hp-asean/blob/master/_includes/js/config.js) (Widget configuration), [`_includes/js/script.js`](https://github.com/kitelloran/hp-asean/blob/master/_includes/js/script.js) (Home statistics), [`home.md`](https://github.com/kitelloran/hp-asean/blob/master/home.md) (Hosted portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Portal experience"]
  node_site["Hosted portal<br/>[home.md]"]
  node_portal_config["Widget configuration<br/>[config.js]"]
  node_home_statistics["Home statistics<br/>[script.js]"]
end

subgraph group_exploration["Data exploration"]
  node_occurrence_search["Occurrence search<br/>[search.md]"]
  node_literature_search["Literature search<br/>[search.md]"]
  node_collection_search["Collection search<br/>[collection.md]"]
  node_institution_search["Institution search<br/>[institution.md]"]
end

subgraph group_content["Reference content"]
  node_taxonomic_content["Taxonomy<br/>[taxonomy.md]"]
  node_specimen_content["Specimens<br/>[specimens.md]"]
  node_portal_resources["Portal resources<br/>[data.md]"]
end

subgraph group_integration["GBIF integration"]
  node_gbif_widgets["GBIF widgets"]
  node_gbif_graphql["GBIF GraphQL"]
end

node_visitor(("Portal visitor"))

node_visitor -->|"visits"| node_site
node_portal_config -->|"extends theme"| node_gbif_widgets
node_home_statistics -->|"fetches counts"| node_gbif_graphql

click node_site "https://github.com/kitelloran/hp-asean/blob/master/home.md"
click node_portal_config "https://github.com/kitelloran/hp-asean/blob/master/_includes/js/config.js"
click node_occurrence_search "https://github.com/kitelloran/hp-asean/blob/master/occurrence/search.md"
click node_literature_search "https://github.com/kitelloran/hp-asean/blob/master/literature/search.md"
click node_collection_search "https://github.com/kitelloran/hp-asean/blob/master/collection.md"
click node_institution_search "https://github.com/kitelloran/hp-asean/blob/master/institution.md"
click node_taxonomic_content "https://github.com/kitelloran/hp-asean/blob/master/taxonomy.md"
click node_specimen_content "https://github.com/kitelloran/hp-asean/blob/master/specimens.md"
click node_portal_resources "https://github.com/kitelloran/hp-asean/blob/master/data.md"
click node_home_statistics "https://github.com/kitelloran/hp-asean/blob/master/_includes/js/script.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_site,node_portal_config,node_home_statistics toneBlue
class node_occurrence_search,node_literature_search,node_collection_search,node_institution_search toneAmber
class node_taxonomic_content,node_specimen_content,node_portal_resources toneMint
class node_gbif_widgets,node_gbif_graphql toneRose
class node_visitor toneIndigo
```

## Components

### Portal experience

- [Hosted portal](https://github.com/kitelloran/hp-asean/blob/master/home.md): `home.md`
- [Widget configuration](https://github.com/kitelloran/hp-asean/blob/master/_includes/js/config.js): `_includes/js/config.js`
- [Home statistics](https://github.com/kitelloran/hp-asean/blob/master/_includes/js/script.js): `_includes/js/script.js`

### Data exploration

- [Occurrence search](https://github.com/kitelloran/hp-asean/blob/master/occurrence/search.md): `occurrence/search.md`
- [Literature search](https://github.com/kitelloran/hp-asean/blob/master/literature/search.md): `literature/search.md`
- [Collection search](https://github.com/kitelloran/hp-asean/blob/master/collection.md): `collection.md`
- [Institution search](https://github.com/kitelloran/hp-asean/blob/master/institution.md): `institution.md`

### Reference content

- [Taxonomy](https://github.com/kitelloran/hp-asean/blob/master/taxonomy.md): `taxonomy.md`
- [Specimens](https://github.com/kitelloran/hp-asean/blob/master/specimens.md): `specimens.md`
- [Portal resources](https://github.com/kitelloran/hp-asean/blob/master/data.md): `data.md`

### GBIF integration

- **GBIF widgets**
- **GBIF GraphQL**

### Other components

- **Portal visitor**

## Connections

- Portal visitor → Hosted portal: visits (evidence: `README.md`)
- Widget configuration → GBIF widgets: extends theme (evidence: `_includes/js/config.js`)
- Home statistics → GBIF GraphQL: fetches counts (evidence: `_includes/js/script.js`)
