# freddiequinson/sam-tsx architecture

> Architecture diagram of the GitHub repository freddiequinson/sam-tsx, 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/freddiequinson/sam-tsx
- Repository: https://github.com/freddiequinson/sam-tsx

## Overview

This is a localized, multi-page React/TypeScript marketing site for Maddy Group. A visitor requests a page; Express serves static assets or sends the path through document rendering and the route registry, which selects a page component. The site includes company, contact, legal, product/appetite, partner, and technology-service pages, with partner and technology content driven by configuration. Shared layout components provide navigation and footer presentation. The excerpts establish routing and several page/config relationships; detailed composition for many pages and the newsletter integration was not fully shown.

Main entry points: [`src/sitePages.ts`](https://github.com/freddiequinson/sam-tsx/blob/master/src/sitePages.ts) (Route registry), [`src/pages/PartnerServicePage.tsx`](https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/PartnerServicePage.tsx) (Partner services), [`src/pages/TechnologyServicePage.tsx`](https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/TechnologyServicePage.tsx) (Technology services), [`src/components/layout/Footer.tsx`](https://github.com/freddiequinson/sam-tsx/blob/master/src/components/layout/Footer.tsx) (Footer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_delivery["Request and rendering"]
  node_express["Express server<br/>[server.ts]"]
  node_document["Document renderer<br/>[renderDocument.tsx]"]
  node_registry["Route registry<br/>[sitePages.ts]"]
end

subgraph group_pages["Page experiences"]
  node_app["Home page<br/>[App.tsx]"]
  node_products["Products appetite"]
  node_brokers["Retail brokers"]
  node_carriers["Carriers<br/>[CarriersPage.tsx]"]
  node_about["About us<br/>[AboutUsPage.tsx]"]
  node_contact["Get in touch<br/>[GetInTouchPage.tsx]"]
  node_legal["Legal pages<br/>[LegalPages.tsx]"]
  node_partner["Partner services"]
  node_technology["Technology services"]
  node_notfound["Not found page<br/>[NotFoundPage.tsx]"]
end

subgraph group_content["Page configuration"]
  node_partnerdata["Partner catalog<br/>[partnerPages.ts]"]
  node_technologydata["Technology catalog<br/>[technologyPages.ts]"]
  node_technav["Technology navigation<br/>[technologyNav.ts]"]
  node_pagecode["Page interactions<br/>[pageCode.ts]"]
  node_sitecode["Site interactions<br/>[sitePageCode.ts]"]
end

subgraph group_shared["Shared presentation"]
  node_header["Header navigation<br/>[Header.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_layout["Document layout<br/>[SiteDocument.tsx]"]
end

node_visitor(("Site visitor"))

node_visitor -->|"requests page"| node_express
node_express -->|"renders path"| node_document
node_express -->|"renders fallback"| node_notfound
node_document -->|"looks up route"| node_registry
node_registry -->|"registers home"| node_app
node_registry -->|"registers page"| node_products
node_registry -->|"registers page"| node_brokers
node_registry -->|"registers page"| node_carriers
node_registry -->|"registers page"| node_about
node_registry -->|"registers page"| node_contact
node_registry -->|"registers pages"| node_legal
node_registry -->|"registers pages"| node_partner
node_registry -->|"registers pages"| node_technology
node_registry -->|"builds partner routes"| node_partnerdata
node_registry -->|"builds technology routes"| node_technologydata
node_partner -->|"uses page config"| node_partnerdata
node_technology -->|"uses page config"| node_technologydata
node_header -->|"uses navigation"| node_technav
node_footer -->|"uses navigation"| node_technav
node_partner -->|"renders footer"| node_footer
node_technology -->|"renders footer"| node_footer
node_partner -->|"embeds interactions"| node_sitecode
node_technology -->|"embeds interactions"| node_sitecode
node_products -->|"embeds interactions"| node_sitecode
node_layout -.->|"includes navigation"| node_header
node_layout -.->|"includes footer"| node_footer

click node_express "https://github.com/freddiequinson/sam-tsx/blob/master/src/server.ts"
click node_document "https://github.com/freddiequinson/sam-tsx/blob/master/src/renderDocument.tsx"
click node_registry "https://github.com/freddiequinson/sam-tsx/blob/master/src/sitePages.ts"
click node_app "https://github.com/freddiequinson/sam-tsx/blob/master/src/App.tsx"
click node_products "https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/ProductsAppetitePage.tsx"
click node_brokers "https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/RetailBrokersPage.tsx"
click node_carriers "https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/CarriersPage.tsx"
click node_about "https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/AboutUsPage.tsx"
click node_contact "https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/GetInTouchPage.tsx"
click node_legal "https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/LegalPages.tsx"
click node_partner "https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/PartnerServicePage.tsx"
click node_technology "https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/TechnologyServicePage.tsx"
click node_notfound "https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/NotFoundPage.tsx"
click node_partnerdata "https://github.com/freddiequinson/sam-tsx/blob/master/src/content/partnerPages.ts"
click node_technologydata "https://github.com/freddiequinson/sam-tsx/blob/master/src/content/technologyPages.ts"
click node_technav "https://github.com/freddiequinson/sam-tsx/blob/master/src/content/technologyNav.ts"
click node_pagecode "https://github.com/freddiequinson/sam-tsx/blob/master/src/content/pageCode.ts"
click node_sitecode "https://github.com/freddiequinson/sam-tsx/blob/master/src/content/sitePageCode.ts"
click node_header "https://github.com/freddiequinson/sam-tsx/blob/master/src/components/layout/Header.tsx"
click node_footer "https://github.com/freddiequinson/sam-tsx/blob/master/src/components/layout/Footer.tsx"
click node_layout "https://github.com/freddiequinson/sam-tsx/blob/master/src/components/layout/SiteDocument.tsx"

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_express,node_document,node_registry toneBlue
class node_app,node_products,node_brokers,node_carriers,node_about,node_contact,node_legal,node_partner,node_technology,node_notfound toneAmber
class node_partnerdata,node_technologydata,node_technav,node_pagecode,node_sitecode toneMint
class node_header,node_footer,node_layout toneRose
class node_visitor toneIndigo
```

## Components

### Request and rendering

- [Express server](https://github.com/freddiequinson/sam-tsx/blob/master/src/server.ts): `src/server.ts`
- [Document renderer](https://github.com/freddiequinson/sam-tsx/blob/master/src/renderDocument.tsx): `src/renderDocument.tsx`
- [Route registry](https://github.com/freddiequinson/sam-tsx/blob/master/src/sitePages.ts): `src/sitePages.ts`

### Page experiences

- [Home page](https://github.com/freddiequinson/sam-tsx/blob/master/src/App.tsx): `src/App.tsx`
- [Products appetite](https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/ProductsAppetitePage.tsx): `src/pages/ProductsAppetitePage.tsx`
- [Retail brokers](https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/RetailBrokersPage.tsx): `src/pages/RetailBrokersPage.tsx`
- [Carriers](https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/CarriersPage.tsx): `src/pages/CarriersPage.tsx`
- [About us](https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/AboutUsPage.tsx): `src/pages/AboutUsPage.tsx`
- [Get in touch](https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/GetInTouchPage.tsx): `src/pages/GetInTouchPage.tsx`
- [Legal pages](https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/LegalPages.tsx): `src/pages/LegalPages.tsx`
- [Partner services](https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/PartnerServicePage.tsx): `src/pages/PartnerServicePage.tsx`
- [Technology services](https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/TechnologyServicePage.tsx): `src/pages/TechnologyServicePage.tsx`
- [Not found page](https://github.com/freddiequinson/sam-tsx/blob/master/src/pages/NotFoundPage.tsx): `src/pages/NotFoundPage.tsx`

### Page configuration

- [Partner catalog](https://github.com/freddiequinson/sam-tsx/blob/master/src/content/partnerPages.ts): `src/content/partnerPages.ts`
- [Technology catalog](https://github.com/freddiequinson/sam-tsx/blob/master/src/content/technologyPages.ts): `src/content/technologyPages.ts`
- [Technology navigation](https://github.com/freddiequinson/sam-tsx/blob/master/src/content/technologyNav.ts): `src/content/technologyNav.ts`
- [Page interactions](https://github.com/freddiequinson/sam-tsx/blob/master/src/content/pageCode.ts): `src/content/pageCode.ts`
- [Site interactions](https://github.com/freddiequinson/sam-tsx/blob/master/src/content/sitePageCode.ts): `src/content/sitePageCode.ts`

### Shared presentation

- [Header navigation](https://github.com/freddiequinson/sam-tsx/blob/master/src/components/layout/Header.tsx): `src/components/layout/Header.tsx`
- [Footer](https://github.com/freddiequinson/sam-tsx/blob/master/src/components/layout/Footer.tsx): `src/components/layout/Footer.tsx`
- [Document layout](https://github.com/freddiequinson/sam-tsx/blob/master/src/components/layout/SiteDocument.tsx): `src/components/layout/SiteDocument.tsx`

### Other components

- **Site visitor**

## Connections

- Site visitor → Express server: requests page (evidence: `src/server.ts`)
- Express server → Document renderer: renders path (evidence: `src/server.ts`)
- Express server → Not found page: renders fallback (evidence: `src/server.ts`)
- Document renderer → Route registry: looks up route (evidence: `src/renderDocument.tsx`)
- Route registry → Home page: registers home (evidence: `src/sitePages.ts`)
- Route registry → Products appetite: registers page (evidence: `src/sitePages.ts`)
- Route registry → Retail brokers: registers page (evidence: `src/sitePages.ts`)
- Route registry → Carriers: registers page (evidence: `src/sitePages.ts`)
- Route registry → About us: registers page (evidence: `src/sitePages.ts`)
- Route registry → Get in touch: registers page (evidence: `src/sitePages.ts`)
- Route registry → Legal pages: registers pages (evidence: `src/sitePages.ts`)
- Route registry → Partner services: registers pages (evidence: `src/sitePages.ts`)
- Route registry → Technology services: registers pages (evidence: `src/sitePages.ts`)
- Route registry → Partner catalog: builds partner routes (evidence: `src/sitePages.ts`)
- Route registry → Technology catalog: builds technology routes (evidence: `src/sitePages.ts`)
- Partner services → Partner catalog: uses page config (evidence: `src/pages/PartnerServicePage.tsx`)
- Technology services → Technology catalog: uses page config (evidence: `src/pages/TechnologyServicePage.tsx`)
- Header navigation → Technology navigation: uses navigation (evidence: `src/components/layout/Header.tsx`)
- Footer → Technology navigation: uses navigation (evidence: `src/components/layout/Footer.tsx`)
- Partner services → Footer: renders footer (evidence: `src/pages/PartnerServicePage.tsx`)
- Technology services → Footer: renders footer (evidence: `src/pages/TechnologyServicePage.tsx`)
- Partner services → Site interactions: embeds interactions (evidence: `src/pages/PartnerServicePage.tsx`)
- Technology services → Site interactions: embeds interactions (evidence: `src/pages/TechnologyServicePage.tsx`)
- Products appetite → Site interactions: embeds interactions (evidence: `src/pages/ProductsAppetitePage.tsx`)
- Document layout → Header navigation: includes navigation
- Document layout → Footer: includes footer
