# shoirly/website architecture

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

- Interactive diagram: https://gitdiagram.com/shoirly/website
- Repository: https://github.com/shoirly/website

## Overview

Shoirly’s repository is a marketing and product-explainer website, not the evidence-capture product runtime. Its principal visitor journey presents how agent actions become signed, attributable records, demonstrates coverage and customer-specific evidence packs, then directs prospective customers to a demo. Product stages and deployment/security claims are represented as documented content and illustrations. The graph focuses on visitor-facing routes, shared presentation, sample evidence, and lead conversion; relationships for unsampled routes are included only where documented by the README or sampled imports.

Main entry points: [`src/app/page.tsx`](https://github.com/shoirly/website/blob/main/src/app/page.tsx) (Homepage), [`src/components/layout/ClosingCta.tsx`](https://github.com/shoirly/website/blob/main/src/components/layout/ClosingCta.tsx) (Demo call to action), [`src/app/product/page.tsx`](https://github.com/shoirly/website/blob/main/src/app/product/page.tsx) (Product overview), [`src/app/solutions/agent-vendors/page.tsx`](https://github.com/shoirly/website/blob/main/src/app/solutions/agent-vendors/page.tsx) (Agent vendor solution)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_journey["Visitor journey"]
  node_home["Homepage<br/>[page.tsx]"]
  node_cta["Demo call to action<br/>[ClosingCta.tsx]"]
end

subgraph group_product["Product explanation"]
  node_productpage["Product overview<br/>[page.tsx]"]
  node_story["Workflow story<br/>[ScrollStory.tsx]"]
  node_scenes["Workflow scenes<br/>[StoryScenes.tsx]"]
  node_architecture["Architecture diagram"]
  node_pack["Evidence pack card<br/>[PackCard.tsx]"]
  node_evidencepreview["Evidence preview"]
  node_deployment["Deployment explanation<br/>[Deployment.tsx]"]
  node_trust["Trust centre<br/>[TrustCentre.tsx]"]
end

subgraph group_audience["Audience content"]
  node_calculator["Deal-stall calculator"]
  node_vendor["Agent vendor solution<br/>[page.tsx]"]
  node_banks["Bank solution<br/>[page.tsx]"]
  node_dora["DORA guide<br/>[page.tsx]"]
  node_security["Security page<br/>[page.tsx]"]
  node_blog["Blog<br/>[page.tsx]"]
  node_about["About page<br/>[page.tsx]"]
  node_legal["Legal pages<br/>[LegalPage.tsx]"]
end

subgraph group_shared["Shared site services"]
  node_siteconfig["Site links and contact<br/>[site.ts]"]
  node_metadata["Page metadata<br/>[metadata.ts]"]
  node_layout["Page layout primitives<br/>[Layout.tsx]"]
end

subgraph group_content["Illustrative content"]
  node_sample["Illustrative records<br/>[sample.ts]"]
end

node_visitor(("Site visitor"))
node_externaldemo(("Shoirly team"))

node_visitor -->|"visits"| node_home
node_visitor -.->|"explores"| node_productpage
node_visitor -.->|"explores"| node_vendor
node_visitor -.->|"explores"| node_banks
node_visitor -.->|"explores"| node_dora
node_visitor -.->|"explores"| node_security
node_visitor -.->|"reads"| node_blog
node_visitor -.->|"explores"| node_about
node_home -->|"renders"| node_story
node_home -->|"renders"| node_evidencepreview
node_home -->|"renders"| node_deployment
node_home -->|"renders"| node_trust
node_home -->|"renders"| node_calculator
node_home -->|"renders"| node_cta
node_productpage -->|"renders"| node_story
node_productpage -->|"renders"| node_architecture
node_productpage -->|"renders"| node_pack
node_productpage -->|"renders"| node_cta
node_story -->|"renders"| node_scenes
node_home -->|"renders"| node_scenes
node_evidencepreview -->|"reads"| node_sample
node_vendor -->|"renders"| node_calculator
node_vendor -->|"renders"| node_cta
node_banks -->|"renders"| node_cta
node_dora -->|"renders"| node_cta
node_security -->|"renders"| node_cta
node_about -->|"renders"| node_cta
node_legal -->|"uses"| node_layout
node_cta -->|"invites"| node_externaldemo
node_cta -.->|"links via"| node_siteconfig
node_home -->|"sets metadata"| node_metadata
node_productpage -->|"sets metadata"| node_metadata
node_dora -->|"sets metadata"| node_metadata
node_home -.->|"uses"| node_layout
node_productpage -->|"uses"| node_layout

click node_home "https://github.com/shoirly/website/blob/main/src/app/page.tsx"
click node_productpage "https://github.com/shoirly/website/blob/main/src/app/product/page.tsx"
click node_story "https://github.com/shoirly/website/blob/main/src/components/story/ScrollStory.tsx"
click node_scenes "https://github.com/shoirly/website/blob/main/src/components/story/StoryScenes.tsx"
click node_architecture "https://github.com/shoirly/website/blob/main/src/components/product/ArchitectureDiagram.tsx"
click node_pack "https://github.com/shoirly/website/blob/main/src/components/product/PackCard.tsx"
click node_evidencepreview "https://github.com/shoirly/website/blob/main/src/components/home/EvidencePreview.tsx"
click node_sample "https://github.com/shoirly/website/blob/main/src/content/sample.ts"
click node_deployment "https://github.com/shoirly/website/blob/main/src/components/home/Deployment.tsx"
click node_trust "https://github.com/shoirly/website/blob/main/src/components/home/TrustCentre.tsx"
click node_calculator "https://github.com/shoirly/website/blob/main/src/components/calculator/StalledDealCalculator.tsx"
click node_vendor "https://github.com/shoirly/website/blob/main/src/app/solutions/agent-vendors/page.tsx"
click node_banks "https://github.com/shoirly/website/blob/main/src/app/solutions/banks/page.tsx"
click node_dora "https://github.com/shoirly/website/blob/main/src/app/dora/page.tsx"
click node_security "https://github.com/shoirly/website/blob/main/src/app/security/page.tsx"
click node_blog "https://github.com/shoirly/website/blob/main/src/app/blog/page.tsx"
click node_about "https://github.com/shoirly/website/blob/main/src/app/about/page.tsx"
click node_legal "https://github.com/shoirly/website/blob/main/src/components/layout/LegalPage.tsx"
click node_cta "https://github.com/shoirly/website/blob/main/src/components/layout/ClosingCta.tsx"
click node_siteconfig "https://github.com/shoirly/website/blob/main/src/config/site.ts"
click node_metadata "https://github.com/shoirly/website/blob/main/src/lib/metadata.ts"
click node_layout "https://github.com/shoirly/website/blob/main/src/components/ui/Layout.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_home,node_cta toneBlue
class node_productpage,node_story,node_scenes,node_architecture,node_pack,node_evidencepreview,node_deployment,node_trust toneAmber
class node_calculator,node_vendor,node_banks,node_dora,node_security,node_blog,node_about,node_legal toneMint
class node_siteconfig,node_metadata,node_layout toneRose
class node_sample,node_visitor,node_externaldemo toneIndigo
```

## Components

### Visitor journey

- [Homepage](https://github.com/shoirly/website/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Demo call to action](https://github.com/shoirly/website/blob/main/src/components/layout/ClosingCta.tsx): `src/components/layout/ClosingCta.tsx`

### Product explanation

- [Product overview](https://github.com/shoirly/website/blob/main/src/app/product/page.tsx): `src/app/product/page.tsx`
- [Workflow story](https://github.com/shoirly/website/blob/main/src/components/story/ScrollStory.tsx): `src/components/story/ScrollStory.tsx`
- [Workflow scenes](https://github.com/shoirly/website/blob/main/src/components/story/StoryScenes.tsx): `src/components/story/StoryScenes.tsx`
- [Architecture diagram](https://github.com/shoirly/website/blob/main/src/components/product/ArchitectureDiagram.tsx): `src/components/product/ArchitectureDiagram.tsx`
- [Evidence pack card](https://github.com/shoirly/website/blob/main/src/components/product/PackCard.tsx): `src/components/product/PackCard.tsx`
- [Evidence preview](https://github.com/shoirly/website/blob/main/src/components/home/EvidencePreview.tsx): `src/components/home/EvidencePreview.tsx`
- [Deployment explanation](https://github.com/shoirly/website/blob/main/src/components/home/Deployment.tsx): `src/components/home/Deployment.tsx`
- [Trust centre](https://github.com/shoirly/website/blob/main/src/components/home/TrustCentre.tsx): `src/components/home/TrustCentre.tsx`

### Audience content

- [Deal-stall calculator](https://github.com/shoirly/website/blob/main/src/components/calculator/StalledDealCalculator.tsx): `src/components/calculator/StalledDealCalculator.tsx`
- [Agent vendor solution](https://github.com/shoirly/website/blob/main/src/app/solutions/agent-vendors/page.tsx): `src/app/solutions/agent-vendors/page.tsx`
- [Bank solution](https://github.com/shoirly/website/blob/main/src/app/solutions/banks/page.tsx): `src/app/solutions/banks/page.tsx`
- [DORA guide](https://github.com/shoirly/website/blob/main/src/app/dora/page.tsx): `src/app/dora/page.tsx`
- [Security page](https://github.com/shoirly/website/blob/main/src/app/security/page.tsx): `src/app/security/page.tsx`
- [Blog](https://github.com/shoirly/website/blob/main/src/app/blog/page.tsx): `src/app/blog/page.tsx`
- [About page](https://github.com/shoirly/website/blob/main/src/app/about/page.tsx): `src/app/about/page.tsx`
- [Legal pages](https://github.com/shoirly/website/blob/main/src/components/layout/LegalPage.tsx): `src/components/layout/LegalPage.tsx`

### Shared site services

- [Site links and contact](https://github.com/shoirly/website/blob/main/src/config/site.ts): `src/config/site.ts`
- [Page metadata](https://github.com/shoirly/website/blob/main/src/lib/metadata.ts): `src/lib/metadata.ts`
- [Page layout primitives](https://github.com/shoirly/website/blob/main/src/components/ui/Layout.tsx): `src/components/ui/Layout.tsx`

### Illustrative content

- [Illustrative records](https://github.com/shoirly/website/blob/main/src/content/sample.ts): `src/content/sample.ts`

### Other components

- **Site visitor**
- **Shoirly team**

## Connections

- Site visitor → Homepage: visits (evidence: `src/app/page.tsx`)
- Site visitor → Product overview: explores
- Site visitor → Agent vendor solution: explores
- Site visitor → Bank solution: explores
- Site visitor → DORA guide: explores
- Site visitor → Security page: explores
- Site visitor → Blog: reads
- Site visitor → About page: explores
- Homepage → Workflow story: renders (evidence: `src/app/page.tsx`)
- Homepage → Evidence preview: renders (evidence: `src/app/page.tsx`)
- Homepage → Deployment explanation: renders (evidence: `src/app/page.tsx`)
- Homepage → Trust centre: renders (evidence: `src/app/page.tsx`)
- Homepage → Deal-stall calculator: renders (evidence: `src/app/page.tsx`)
- Homepage → Demo call to action: renders (evidence: `src/app/page.tsx`)
- Product overview → Workflow story: renders (evidence: `src/app/product/page.tsx`)
- Product overview → Architecture diagram: renders (evidence: `src/app/product/page.tsx`)
- Product overview → Evidence pack card: renders (evidence: `src/app/product/page.tsx`)
- Product overview → Demo call to action: renders (evidence: `src/app/product/page.tsx`)
- Workflow story → Workflow scenes: renders (evidence: `src/app/product/page.tsx`)
- Homepage → Workflow scenes: renders (evidence: `src/app/page.tsx`)
- Evidence preview → Illustrative records: reads (evidence: `src/components/home/EvidencePreview.tsx`)
- Agent vendor solution → Deal-stall calculator: renders (evidence: `src/app/solutions/agent-vendors/page.tsx`)
- Agent vendor solution → Demo call to action: renders (evidence: `src/app/solutions/agent-vendors/page.tsx`)
- Bank solution → Demo call to action: renders (evidence: `src/app/solutions/banks/page.tsx`)
- DORA guide → Demo call to action: renders (evidence: `src/app/dora/page.tsx`)
- Security page → Demo call to action: renders (evidence: `src/app/security/page.tsx`)
- About page → Demo call to action: renders (evidence: `src/app/about/page.tsx`)
- Legal pages → Page layout primitives: uses (evidence: `src/components/layout/LegalPage.tsx`)
- Demo call to action → Shoirly team: invites (evidence: `src/components/layout/ClosingCta.tsx`)
- Demo call to action → Site links and contact: links via
- Homepage → Page metadata: sets metadata (evidence: `src/app/page.tsx`)
- Product overview → Page metadata: sets metadata (evidence: `src/app/product/page.tsx`)
- DORA guide → Page metadata: sets metadata (evidence: `src/app/dora/page.tsx`)
- Homepage → Page layout primitives: uses
- Product overview → Page layout primitives: uses (evidence: `src/app/product/page.tsx`)
