# processing/p5.js-website architecture

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

- Interactive diagram: https://gitdiagram.com/processing/p5.js-website
- Repository: https://github.com/processing/p5.js-website

## Overview

This repository is the p5.js website: visitors browse localized documentation and reference material, discover libraries and community content, and try editable, runnable sketches embedded in pages. Astro content collections define the site’s content domains; page utilities provide locale-aware content and route handling, while UI components implement search, reference filtering, navigation, accessibility, and sketch controls. The README documents the product capabilities; sampled imports support the specific component links shown. Several content domains and builders are represented by their exact tree paths, but their internal runtime wiring was not sampled.

Main entry points: [`src/content.config.ts`](https://github.com/processing/p5.js-website/blob/main/src/content.config.ts) (Astro collections), [`src/components/CodeEmbed/index.jsx`](https://github.com/processing/p5.js-website/blob/main/src/components/CodeEmbed/index.jsx) (Sketch editor), [`src/content/shared.ts`](https://github.com/processing/p5.js-website/blob/main/src/content/shared.ts) (Content schemas), [`src/pages/_utils.ts`](https://github.com/processing/p5.js-website/blob/main/src/pages/_utils.ts) (Page utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Content domains"]
  node_reference["API reference<br/>[config.ts]"]
  node_tutorials["Tutorials"]
  node_examples["Examples"]
  node_libraries["Libraries<br/>[config.ts]"]
  node_community["People and events<br/>[config.ts]"]
  node_contribute["Contributor docs<br/>[config.ts]"]
end

subgraph group_site["Site experience"]
  node_search["Search interface<br/>[index.tsx]"]
  node_results["Search results<br/>[index.tsx]"]
  node_refdirectory["Reference directory<br/>[index.tsx]"]
  node_accessibility["Accessibility controls<br/>[index.tsx]"]
  node_navigation["Site navigation"]
end

subgraph group_sketch["Sketch interaction"]
  node_embed["Sketch editor<br/>[index.jsx]"]
  node_frame["Sketch frame<br/>[frame.tsx]"]
  node_live["Live announcements<br/>[useLiveRegion.ts]"]
  node_p5cdn(("p5.js CDN"))
end

subgraph group_foundation["Content and locale"]
  node_astro["Astro collections<br/>[content.config.ts]"]
  node_shared["Content schemas<br/>[shared.ts]"]
  node_utils["Page utilities<br/>[_utils.ts]"]
  node_nodeutils["Route utilities<br/>[_utils-node.ts]"]
  node_locales["Locale definitions<br/>[const.ts]"]
end

node_visitor(("Website visitor"))

node_visitor -->|"browses"| node_astro
node_astro -->|"registers"| node_reference
node_astro -->|"registers"| node_tutorials
node_astro -->|"registers"| node_examples
node_astro -->|"registers"| node_libraries
node_astro -->|"registers"| node_community
node_astro -->|"registers"| node_contribute
node_reference -->|"uses schemas"| node_shared
node_libraries -->|"uses schemas"| node_shared
node_community -->|"uses schemas"| node_shared
node_contribute -->|"uses schemas"| node_shared
node_utils -->|"reads collection"| node_reference
node_utils -->|"delegates routes"| node_nodeutils
node_utils -->|"uses locale"| node_locales
node_visitor -->|"searches"| node_search
node_search -->|"renders"| node_results
node_visitor -->|"filters reference"| node_refdirectory
node_visitor -->|"adjusts accessibility"| node_accessibility
node_visitor -->|"navigates"| node_navigation
node_visitor -->|"edits sketch"| node_embed
node_embed -->|"renders preview"| node_frame
node_embed -->|"announces status"| node_live
node_embed -->|"loads library"| node_p5cdn

click node_astro "https://github.com/processing/p5.js-website/blob/main/src/content.config.ts"
click node_shared "https://github.com/processing/p5.js-website/blob/main/src/content/shared.ts"
click node_utils "https://github.com/processing/p5.js-website/blob/main/src/pages/_utils.ts"
click node_nodeutils "https://github.com/processing/p5.js-website/blob/main/src/pages/_utils-node.ts"
click node_locales "https://github.com/processing/p5.js-website/blob/main/src/i18n/const.ts"
click node_reference "https://github.com/processing/p5.js-website/blob/main/src/content/reference/config.ts"
click node_tutorials "https://github.com/processing/p5.js-website/tree/main/src/content/tutorials"
click node_examples "https://github.com/processing/p5.js-website/tree/main/src/content/examples"
click node_libraries "https://github.com/processing/p5.js-website/blob/main/src/content/libraries/config.ts"
click node_community "https://github.com/processing/p5.js-website/blob/main/src/content/people/config.ts"
click node_contribute "https://github.com/processing/p5.js-website/blob/main/src/content/contributor-docs/config.ts"
click node_search "https://github.com/processing/p5.js-website/blob/main/src/components/SearchProvider/index.tsx"
click node_results "https://github.com/processing/p5.js-website/blob/main/src/components/SearchResults/index.tsx"
click node_refdirectory "https://github.com/processing/p5.js-website/blob/main/src/components/ReferenceDirectoryWithFilter/index.tsx"
click node_accessibility "https://github.com/processing/p5.js-website/blob/main/src/components/AccessibilitySettings/index.tsx"
click node_navigation "https://github.com/processing/p5.js-website/tree/main/src/components/Nav"
click node_embed "https://github.com/processing/p5.js-website/blob/main/src/components/CodeEmbed/index.jsx"
click node_frame "https://github.com/processing/p5.js-website/blob/main/src/components/CodeEmbed/frame.tsx"
click node_live "https://github.com/processing/p5.js-website/blob/main/src/components/hooks/useLiveRegion.ts"

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_reference,node_tutorials,node_examples,node_libraries,node_community,node_contribute toneBlue
class node_search,node_results,node_refdirectory,node_accessibility,node_navigation toneAmber
class node_embed,node_frame,node_live,node_p5cdn toneMint
class node_astro,node_shared,node_utils,node_nodeutils,node_locales toneRose
class node_visitor toneIndigo
```

## Components

### Content domains

- [API reference](https://github.com/processing/p5.js-website/blob/main/src/content/reference/config.ts): `src/content/reference/config.ts`
- [Tutorials](https://github.com/processing/p5.js-website/tree/main/src/content/tutorials): `src/content/tutorials`
- [Examples](https://github.com/processing/p5.js-website/tree/main/src/content/examples): `src/content/examples`
- [Libraries](https://github.com/processing/p5.js-website/blob/main/src/content/libraries/config.ts): `src/content/libraries/config.ts`
- [People and events](https://github.com/processing/p5.js-website/blob/main/src/content/people/config.ts): `src/content/people/config.ts`
- [Contributor docs](https://github.com/processing/p5.js-website/blob/main/src/content/contributor-docs/config.ts): `src/content/contributor-docs/config.ts`

### Site experience

- [Search interface](https://github.com/processing/p5.js-website/blob/main/src/components/SearchProvider/index.tsx): `src/components/SearchProvider/index.tsx`
- [Search results](https://github.com/processing/p5.js-website/blob/main/src/components/SearchResults/index.tsx): `src/components/SearchResults/index.tsx`
- [Reference directory](https://github.com/processing/p5.js-website/blob/main/src/components/ReferenceDirectoryWithFilter/index.tsx): `src/components/ReferenceDirectoryWithFilter/index.tsx`
- [Accessibility controls](https://github.com/processing/p5.js-website/blob/main/src/components/AccessibilitySettings/index.tsx): `src/components/AccessibilitySettings/index.tsx`
- [Site navigation](https://github.com/processing/p5.js-website/tree/main/src/components/Nav): `src/components/Nav`

### Sketch interaction

- [Sketch editor](https://github.com/processing/p5.js-website/blob/main/src/components/CodeEmbed/index.jsx): `src/components/CodeEmbed/index.jsx`
- [Sketch frame](https://github.com/processing/p5.js-website/blob/main/src/components/CodeEmbed/frame.tsx): `src/components/CodeEmbed/frame.tsx`
- [Live announcements](https://github.com/processing/p5.js-website/blob/main/src/components/hooks/useLiveRegion.ts): `src/components/hooks/useLiveRegion.ts`
- **p5.js CDN**

### Content and locale

- [Astro collections](https://github.com/processing/p5.js-website/blob/main/src/content.config.ts): `src/content.config.ts`
- [Content schemas](https://github.com/processing/p5.js-website/blob/main/src/content/shared.ts): `src/content/shared.ts`
- [Page utilities](https://github.com/processing/p5.js-website/blob/main/src/pages/_utils.ts): `src/pages/_utils.ts`
- [Route utilities](https://github.com/processing/p5.js-website/blob/main/src/pages/_utils-node.ts): `src/pages/_utils-node.ts`
- [Locale definitions](https://github.com/processing/p5.js-website/blob/main/src/i18n/const.ts): `src/i18n/const.ts`

### Other components

- **Website visitor**

## Connections

- Website visitor → Astro collections: browses
- Astro collections → API reference: registers (evidence: `src/content.config.ts`)
- Astro collections → Tutorials: registers (evidence: `src/content.config.ts`)
- Astro collections → Examples: registers (evidence: `src/content.config.ts`)
- Astro collections → Libraries: registers (evidence: `src/content.config.ts`)
- Astro collections → People and events: registers (evidence: `src/content.config.ts`)
- Astro collections → Contributor docs: registers (evidence: `src/content.config.ts`)
- API reference → Content schemas: uses schemas (evidence: `src/content/reference/config.ts`)
- Libraries → Content schemas: uses schemas (evidence: `src/content/libraries/config.ts`)
- People and events → Content schemas: uses schemas (evidence: `src/content/people/config.ts`)
- Contributor docs → Content schemas: uses schemas (evidence: `src/content/contributor-docs/config.ts`)
- Page utilities → API reference: reads collection (evidence: `src/pages/_utils.ts`)
- Page utilities → Route utilities: delegates routes (evidence: `src/pages/_utils.ts`)
- Page utilities → Locale definitions: uses locale (evidence: `src/pages/_utils.ts`)
- Website visitor → Search interface: searches
- Search interface → Search results: renders (evidence: `src/components/SearchProvider/index.tsx`)
- Website visitor → Reference directory: filters reference
- Website visitor → Accessibility controls: adjusts accessibility
- Website visitor → Site navigation: navigates
- Website visitor → Sketch editor: edits sketch
- Sketch editor → Sketch frame: renders preview (evidence: `src/components/CodeEmbed/index.jsx`)
- Sketch editor → Live announcements: announces status (evidence: `src/components/CodeEmbed/index.jsx`)
- Sketch editor → p5.js CDN: loads library (evidence: `src/components/CodeEmbed/index.jsx`)
