# ivensarj/wp-code-starter architecture

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

- Interactive diagram: https://gitdiagram.com/ivensarj/wp-code-starter
- Repository: https://github.com/ivensarj/wp-code-starter

## Overview

WP Code Starter is a WordPress block theme for building sites whose structure and styling live in code while content remains editable in Gutenberg. The main workflow is an editor assembling page layouts from templates and patterns, editing content and visual options, then publishing a rendered site. An optional Projects plugin adds project records, area-based filtering and a gallery. The graph combines sampled PHP relationships with README-documented capabilities; unsampled theme templates and assets are shown at their exact tree paths, without inferred call edges.

Main entry points: [`plugins/wpcs-projects/wpcs-projects.php`](https://github.com/ivensarj/wp-code-starter/blob/main/plugins/wpcs-projects/wpcs-projects.php) (Project registration and filtering), [`themes/wp-code-starter/functions.php`](https://github.com/ivensarj/wp-code-starter/blob/main/themes/wp-code-starter/functions.php) (Theme integration), [`plugins/wpcs-projects/blocks/filters/render.php`](https://github.com/ivensarj/wp-code-starter/blob/main/plugins/wpcs-projects/blocks/filters/render.php) (Area filter block), [`themes/wp-code-starter/inc/visual-editor.php`](https://github.com/ivensarj/wp-code-starter/blob/main/themes/wp-code-starter/inc/visual-editor.php) (Visual options)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_theme["Block theme"]
  node_theme_config["Design tokens<br/>[theme.json]"]
  node_templates["Page templates"]
  node_parts["Header and footer"]
  node_patterns["Theme patterns"]
  node_site_css["Shared styles<br/>[site.css]"]
end

subgraph group_editing["Gutenberg editing"]
  node_theme_setup["Theme integration<br/>[functions.php]"]
  node_editor_ui["Editor controls<br/>[editor.js]"]
  node_visual_options["Visual options<br/>[visual-editor.php]"]
end

subgraph group_projects["Projects plugin"]
  node_project_plugin["Project registration and filtering<br/>[wpcs-projects.php]"]
  node_project_records[("Project records and areas<br/>[wpcs-projects.php]")]
  node_filter_block["Area filter block<br/>[render.php]"]
  node_gallery["Project gallery<br/>[gallery.php]"]
end

subgraph group_platform["WordPress runtime"]
  node_wp{{"WordPress"}}
  node_content[("Site content")]
end

node_editor(("Site editor"))
node_visitor(("Site visitor"))

node_editor -->|"edits in"| node_wp
node_wp -->|"stores content"| node_content
node_wp -->|"renders layouts"| node_templates
node_wp -->|"renders shared parts"| node_parts
node_wp -->|"offers patterns"| node_patterns
node_wp -->|"uses design tokens"| node_theme_config
node_wp -->|"loads shared styles"| node_site_css
node_wp -->|"loads theme integration"| node_theme_setup
node_theme_setup -->|"includes"| node_visual_options
node_theme_setup -->|"enqueues"| node_editor_ui
node_wp -->|"filters block rendering"| node_visual_options
node_editor -->|"edits and saves"| node_content
node_visitor -->|"requests site"| node_wp
node_wp -->|"loads plugin"| node_project_plugin
node_project_plugin -->|"registers post type"| node_project_records
node_project_plugin -->|"registers block"| node_filter_block
node_project_plugin -->|"registers pattern"| node_gallery
node_editor -->|"manages projects"| node_project_records
node_wp -->|"renders gallery"| node_gallery
node_filter_block -->|"reads area terms"| node_project_records
node_wp -->|"filters project queries"| node_project_records

click node_theme_config "https://github.com/ivensarj/wp-code-starter/blob/main/themes/wp-code-starter/theme.json"
click node_templates "https://github.com/ivensarj/wp-code-starter/tree/main/themes/wp-code-starter/templates"
click node_parts "https://github.com/ivensarj/wp-code-starter/tree/main/themes/wp-code-starter/parts"
click node_patterns "https://github.com/ivensarj/wp-code-starter/tree/main/themes/wp-code-starter/patterns"
click node_site_css "https://github.com/ivensarj/wp-code-starter/blob/main/themes/wp-code-starter/assets/site.css"
click node_theme_setup "https://github.com/ivensarj/wp-code-starter/blob/main/themes/wp-code-starter/functions.php"
click node_editor_ui "https://github.com/ivensarj/wp-code-starter/blob/main/themes/wp-code-starter/assets/editor.js"
click node_visual_options "https://github.com/ivensarj/wp-code-starter/blob/main/themes/wp-code-starter/inc/visual-editor.php"
click node_project_plugin "https://github.com/ivensarj/wp-code-starter/blob/main/plugins/wpcs-projects/wpcs-projects.php"
click node_project_records "https://github.com/ivensarj/wp-code-starter/blob/main/plugins/wpcs-projects/wpcs-projects.php"
click node_filter_block "https://github.com/ivensarj/wp-code-starter/blob/main/plugins/wpcs-projects/blocks/filters/render.php"
click node_gallery "https://github.com/ivensarj/wp-code-starter/blob/main/plugins/wpcs-projects/patterns/gallery.php"

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_theme_config,node_templates,node_parts,node_patterns,node_site_css toneBlue
class node_theme_setup,node_editor_ui,node_visual_options toneAmber
class node_project_plugin,node_project_records,node_filter_block,node_gallery toneMint
class node_wp,node_content toneRose
class node_editor,node_visitor toneIndigo
```

## Components

### Block theme

- [Design tokens](https://github.com/ivensarj/wp-code-starter/blob/main/themes/wp-code-starter/theme.json): `themes/wp-code-starter/theme.json`
- [Page templates](https://github.com/ivensarj/wp-code-starter/tree/main/themes/wp-code-starter/templates): `themes/wp-code-starter/templates`
- [Header and footer](https://github.com/ivensarj/wp-code-starter/tree/main/themes/wp-code-starter/parts): `themes/wp-code-starter/parts`
- [Theme patterns](https://github.com/ivensarj/wp-code-starter/tree/main/themes/wp-code-starter/patterns): `themes/wp-code-starter/patterns`
- [Shared styles](https://github.com/ivensarj/wp-code-starter/blob/main/themes/wp-code-starter/assets/site.css): `themes/wp-code-starter/assets/site.css`

### Gutenberg editing

- [Theme integration](https://github.com/ivensarj/wp-code-starter/blob/main/themes/wp-code-starter/functions.php): `themes/wp-code-starter/functions.php`
- [Editor controls](https://github.com/ivensarj/wp-code-starter/blob/main/themes/wp-code-starter/assets/editor.js): `themes/wp-code-starter/assets/editor.js`
- [Visual options](https://github.com/ivensarj/wp-code-starter/blob/main/themes/wp-code-starter/inc/visual-editor.php): `themes/wp-code-starter/inc/visual-editor.php`

### Projects plugin

- [Project registration and filtering](https://github.com/ivensarj/wp-code-starter/blob/main/plugins/wpcs-projects/wpcs-projects.php): `plugins/wpcs-projects/wpcs-projects.php`
- [Project records and areas](https://github.com/ivensarj/wp-code-starter/blob/main/plugins/wpcs-projects/wpcs-projects.php): `plugins/wpcs-projects/wpcs-projects.php`
- [Area filter block](https://github.com/ivensarj/wp-code-starter/blob/main/plugins/wpcs-projects/blocks/filters/render.php): `plugins/wpcs-projects/blocks/filters/render.php`
- [Project gallery](https://github.com/ivensarj/wp-code-starter/blob/main/plugins/wpcs-projects/patterns/gallery.php): `plugins/wpcs-projects/patterns/gallery.php`

### WordPress runtime

- **WordPress**
- **Site content**

### Other components

- **Site editor**
- **Site visitor**

## Connections

- Site editor → WordPress: edits in (evidence: `README.md`)
- WordPress → Site content: stores content (evidence: `README.md`)
- WordPress → Page templates: renders layouts (evidence: `README.md`)
- WordPress → Header and footer: renders shared parts (evidence: `README.md`)
- WordPress → Theme patterns: offers patterns (evidence: `README.md`)
- WordPress → Design tokens: uses design tokens (evidence: `README.md`)
- WordPress → Shared styles: loads shared styles
- WordPress → Theme integration: loads theme integration (evidence: `themes/wp-code-starter/functions.php`)
- Theme integration → Visual options: includes (evidence: `themes/wp-code-starter/functions.php`)
- Theme integration → Editor controls: enqueues (evidence: `themes/wp-code-starter/functions.php`)
- WordPress → Visual options: filters block rendering (evidence: `themes/wp-code-starter/inc/visual-editor.php`)
- Site editor → Site content: edits and saves (evidence: `README.md`)
- Site visitor → WordPress: requests site (evidence: `README.md`)
- WordPress → Project registration and filtering: loads plugin (evidence: `plugins/wpcs-projects/wpcs-projects.php`)
- Project registration and filtering → Project records and areas: registers post type (evidence: `plugins/wpcs-projects/wpcs-projects.php`)
- Project registration and filtering → Area filter block: registers block (evidence: `plugins/wpcs-projects/wpcs-projects.php`)
- Project registration and filtering → Project gallery: registers pattern (evidence: `plugins/wpcs-projects/wpcs-projects.php`)
- Site editor → Project records and areas: manages projects (evidence: `README.md`)
- WordPress → Project gallery: renders gallery (evidence: `README.md`)
- Area filter block → Project records and areas: reads area terms (evidence: `plugins/wpcs-projects/blocks/filters/render.php`)
- WordPress → Project records and areas: filters project queries (evidence: `plugins/wpcs-projects/wpcs-projects.php`)
