# bhugraduate/hycyon architecture

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

- Interactive diagram: https://gitdiagram.com/bhugraduate/hycyon
- Repository: https://github.com/bhugraduate/hycyon

## Overview

Hycyon is a brand and product-studio website that introduces its products, services, client work, engineering capabilities and lab, then directs visitors to the site that handles their next task. Its central workflow is a visitor browsing the statically rendered pages and following product or project links. A separate Netlify relay accepts quote/contact submissions from other Hycyon sites and forwards them to Discord. The graph follows documented and excerpted relationships; unsampled frontend and relay details are represented only where the README or source index supports them.

Main entry points: [`src/components/sections.mjs`](https://github.com/bhugraduate/hycyon/blob/main/src/components/sections.mjs) (Site sections), [`src/components/layout.mjs`](https://github.com/bhugraduate/hycyon/blob/main/src/components/layout.mjs) (Page layout), [`src/pages/pages.mjs`](https://github.com/bhugraduate/hycyon/blob/main/src/pages/pages.mjs) (Page assembly), [`build.mjs`](https://github.com/bhugraduate/hycyon/blob/main/build.mjs) (Static site build)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Brand website"]
  node_sitebuild["Static site build<br/>[build.mjs]"]
  node_lastmods["Sitemap dates<br/>[lastmod.mjs]"]
end

subgraph group_content["Content and rendering"]
  node_pageassembly["Page assembly<br/>[pages.mjs]"]
  node_sections["Site sections<br/>[sections.mjs]"]
  node_layout["Page layout<br/>[layout.mjs]"]
  node_ecosystem["Ecosystem diagram<br/>[ecosystem.mjs]"]
  node_templating["HTML templating<br/>[html.mjs]"]
  node_seo["SEO metadata<br/>[seo.mjs]"]
  node_sitefacts["Site facts and links<br/>[site.mjs]"]
  node_productdata["Product catalogue<br/>[products.mjs]"]
  node_servicedata["Service summaries<br/>[services.mjs]"]
  node_editorial["Editorial and work<br/>[content.mjs]"]
end

subgraph group_frontend["Visitor interface"]
  node_staticassets["Styles and assets"]
  node_browserjs["Browser interactions<br/>[main.js]"]
end

subgraph group_relay["Form relay"]
  node_relayentry["Netlify functions<br/>[lead.mjs]"]
  node_healthentry["Health function<br/>[health.mjs]"]
  node_relayhandler["Request handling<br/>[relay.mjs]"]
  node_relaybuild["Relay build stamp<br/>[build.mjs]"]
end

node_visitor(("Visitor"))
node_catalogue["Service catalogue"]
node_portfolio["Engineering portfolio"]
node_productdestinations["Product destinations"]
node_discord["Discord webhook"]

node_visitor -->|"browses"| node_pageassembly
node_sitebuild -->|"renders pages"| node_pageassembly
node_sitebuild -->|"serializes HTML"| node_templating
node_sitebuild -->|"reads site facts"| node_sitefacts
node_sitebuild -->|"dates sitemap"| node_lastmods
node_pageassembly -->|"assembles sections"| node_sections
node_pageassembly -->|"wraps pages"| node_layout
node_pageassembly -->|"adds structured data"| node_seo
node_pageassembly -->|"builds markup"| node_templating
node_sections -->|"renders diagram"| node_ecosystem
node_sections -->|"displays products"| node_productdata
node_sections -->|"displays services"| node_servicedata
node_sections -->|"displays work and lab"| node_editorial
node_sections -->|"uses site links"| node_sitefacts
node_layout -->|"uses navigation facts"| node_sitefacts
node_layout -->|"links products"| node_productdata
node_layout -->|"creates markup"| node_templating
node_seo -->|"describes live products"| node_productdata
node_seo -->|"uses organization facts"| node_sitefacts
node_sections -->|"links project CTA"| node_catalogue
node_sections -->|"links engineering work"| node_portfolio
node_sections -->|"links product sites"| node_productdestinations
node_layout -.->|"loads site styles"| node_staticassets
node_layout -->|"loads interactions"| node_browserjs
node_browserjs -.->|"responds to interaction"| node_visitor
node_relayentry -->|"delegates requests"| node_relayhandler
node_healthentry -->|"checks relay status"| node_relayhandler
node_relayhandler -->|"reads build stamp"| node_relaybuild
node_relayhandler -->|"posts submissions"| node_discord
node_catalogue -.->|"submits quote"| node_relayentry
node_portfolio -.->|"submits contact"| node_relayentry

click node_sitebuild "https://github.com/bhugraduate/hycyon/blob/main/build.mjs"
click node_pageassembly "https://github.com/bhugraduate/hycyon/blob/main/src/pages/pages.mjs"
click node_sections "https://github.com/bhugraduate/hycyon/blob/main/src/components/sections.mjs"
click node_layout "https://github.com/bhugraduate/hycyon/blob/main/src/components/layout.mjs"
click node_ecosystem "https://github.com/bhugraduate/hycyon/blob/main/src/components/ecosystem.mjs"
click node_templating "https://github.com/bhugraduate/hycyon/blob/main/src/lib/html.mjs"
click node_seo "https://github.com/bhugraduate/hycyon/blob/main/src/lib/seo.mjs"
click node_sitefacts "https://github.com/bhugraduate/hycyon/blob/main/src/data/site.mjs"
click node_productdata "https://github.com/bhugraduate/hycyon/blob/main/src/data/products.mjs"
click node_servicedata "https://github.com/bhugraduate/hycyon/blob/main/src/data/services.mjs"
click node_editorial "https://github.com/bhugraduate/hycyon/blob/main/src/data/content.mjs"
click node_staticassets "https://github.com/bhugraduate/hycyon/tree/main/src/assets/css"
click node_browserjs "https://github.com/bhugraduate/hycyon/blob/main/src/assets/js/main.js"
click node_lastmods "https://github.com/bhugraduate/hycyon/blob/main/scripts/lastmod.mjs"
click node_relayentry "https://github.com/bhugraduate/hycyon/blob/main/relay/netlify/functions/lead.mjs"
click node_healthentry "https://github.com/bhugraduate/hycyon/blob/main/relay/netlify/functions/health.mjs"
click node_relayhandler "https://github.com/bhugraduate/hycyon/blob/main/relay/lib/relay.mjs"
click node_relaybuild "https://github.com/bhugraduate/hycyon/blob/main/relay/lib/build.mjs"

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_sitebuild,node_lastmods toneBlue
class node_pageassembly,node_sections,node_layout,node_ecosystem,node_templating,node_seo,node_sitefacts,node_productdata,node_servicedata,node_editorial toneAmber
class node_staticassets,node_browserjs,node_discord toneMint
class node_relayentry,node_healthentry,node_relayhandler,node_relaybuild toneRose
class node_visitor,node_catalogue,node_portfolio,node_productdestinations toneIndigo
```

## Components

### Brand website

- [Static site build](https://github.com/bhugraduate/hycyon/blob/main/build.mjs): `build.mjs`
- [Sitemap dates](https://github.com/bhugraduate/hycyon/blob/main/scripts/lastmod.mjs): `scripts/lastmod.mjs`

### Content and rendering

- [Page assembly](https://github.com/bhugraduate/hycyon/blob/main/src/pages/pages.mjs): `src/pages/pages.mjs`
- [Site sections](https://github.com/bhugraduate/hycyon/blob/main/src/components/sections.mjs): `src/components/sections.mjs`
- [Page layout](https://github.com/bhugraduate/hycyon/blob/main/src/components/layout.mjs): `src/components/layout.mjs`
- [Ecosystem diagram](https://github.com/bhugraduate/hycyon/blob/main/src/components/ecosystem.mjs): `src/components/ecosystem.mjs`
- [HTML templating](https://github.com/bhugraduate/hycyon/blob/main/src/lib/html.mjs): `src/lib/html.mjs`
- [SEO metadata](https://github.com/bhugraduate/hycyon/blob/main/src/lib/seo.mjs): `src/lib/seo.mjs`
- [Site facts and links](https://github.com/bhugraduate/hycyon/blob/main/src/data/site.mjs): `src/data/site.mjs`
- [Product catalogue](https://github.com/bhugraduate/hycyon/blob/main/src/data/products.mjs): `src/data/products.mjs`
- [Service summaries](https://github.com/bhugraduate/hycyon/blob/main/src/data/services.mjs): `src/data/services.mjs`
- [Editorial and work](https://github.com/bhugraduate/hycyon/blob/main/src/data/content.mjs): `src/data/content.mjs`

### Visitor interface

- [Styles and assets](https://github.com/bhugraduate/hycyon/tree/main/src/assets/css): `src/assets/css`
- [Browser interactions](https://github.com/bhugraduate/hycyon/blob/main/src/assets/js/main.js): `src/assets/js/main.js`

### Form relay

- [Netlify functions](https://github.com/bhugraduate/hycyon/blob/main/relay/netlify/functions/lead.mjs): `relay/netlify/functions/lead.mjs`
- [Health function](https://github.com/bhugraduate/hycyon/blob/main/relay/netlify/functions/health.mjs): `relay/netlify/functions/health.mjs`
- [Request handling](https://github.com/bhugraduate/hycyon/blob/main/relay/lib/relay.mjs): `relay/lib/relay.mjs`
- [Relay build stamp](https://github.com/bhugraduate/hycyon/blob/main/relay/lib/build.mjs): `relay/lib/build.mjs`

### Other components

- **Visitor**
- **Service catalogue**
- **Engineering portfolio**
- **Product destinations**
- **Discord webhook**

## Connections

- Visitor → Page assembly: browses (evidence: `README.md`)
- Static site build → Page assembly: renders pages (evidence: `build.mjs`)
- Static site build → HTML templating: serializes HTML (evidence: `build.mjs`)
- Static site build → Site facts and links: reads site facts (evidence: `build.mjs`)
- Static site build → Sitemap dates: dates sitemap (evidence: `build.mjs`)
- Page assembly → Site sections: assembles sections (evidence: `src/pages/pages.mjs`)
- Page assembly → Page layout: wraps pages (evidence: `src/pages/pages.mjs`)
- Page assembly → SEO metadata: adds structured data (evidence: `src/pages/pages.mjs`)
- Page assembly → HTML templating: builds markup (evidence: `src/pages/pages.mjs`)
- Site sections → Ecosystem diagram: renders diagram (evidence: `src/components/sections.mjs`)
- Site sections → Product catalogue: displays products (evidence: `src/components/sections.mjs`)
- Site sections → Service summaries: displays services (evidence: `src/components/sections.mjs`)
- Site sections → Editorial and work: displays work and lab (evidence: `src/components/sections.mjs`)
- Site sections → Site facts and links: uses site links (evidence: `src/components/sections.mjs`)
- Page layout → Site facts and links: uses navigation facts (evidence: `src/components/layout.mjs`)
- Page layout → Product catalogue: links products (evidence: `src/components/layout.mjs`)
- Page layout → HTML templating: creates markup (evidence: `src/components/layout.mjs`)
- SEO metadata → Product catalogue: describes live products (evidence: `src/lib/seo.mjs`)
- SEO metadata → Site facts and links: uses organization facts (evidence: `src/lib/seo.mjs`)
- Site sections → Service catalogue: links project CTA (evidence: `src/components/sections.mjs`)
- Site sections → Engineering portfolio: links engineering work (evidence: `src/components/sections.mjs`)
- Site sections → Product destinations: links product sites
- Page layout → Styles and assets: loads site styles (evidence: `README.md`)
- Page layout → Browser interactions: loads interactions (evidence: `src/components/layout.mjs`)
- Browser interactions → Visitor: responds to interaction (evidence: `README.md`)
- Netlify functions → Request handling: delegates requests (evidence: `relay/netlify/functions/lead.mjs`)
- Health function → Request handling: checks relay status (evidence: `relay/netlify/functions/health.mjs`)
- Request handling → Relay build stamp: reads build stamp (evidence: `relay/lib/relay.mjs`)
- Request handling → Discord webhook: posts submissions (evidence: `relay/lib/relay.mjs`)
- Service catalogue → Netlify functions: submits quote (evidence: `README.md`)
- Engineering portfolio → Netlify functions: submits contact (evidence: `README.md`)
