# rgrapha/novanix architecture

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

- Interactive diagram: https://gitdiagram.com/rgrapha/novanix
- Repository: https://github.com/rgrapha/novanix

## Overview

Novanix is a reusable WordPress child theme for institutional sites. Administrators register services and site-wide contact data, then edit configured fields; WordPress stores those values, and theme templates render home, service, and general-site views for visitors. The map also preserves search, taxonomy, archive, breadcrumb, and not-found capabilities documented by the README. Edges reflect shown template calls, setup behavior, or README-described flows; unsampled templates and scripts are represented without asserting their internal implementation.

Main entry points: [`templates/page-home.php`](https://github.com/rgrapha/novanix/blob/main/templates/page-home.php) (Home and featured services), [`inc/custom-fields.php`](https://github.com/rgrapha/novanix/blob/main/inc/custom-fields.php) (Field registration and saving), [`inc/setup.php`](https://github.com/rgrapha/novanix/blob/main/inc/setup.php) (Theme setup), [`page.php`](https://github.com/rgrapha/novanix/blob/main/page.php) (General page and post)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Content and templates"]
  node_types["Services and taxonomies<br/>[custom-posts.php]"]
  node_helpers["Field and contact helpers<br/>[helpers.php]"]
end

subgraph group_fields["Fields and administration"]
  node_fieldconfig["Field definitions<br/>[config.php]"]
  node_fieldadmin["Field registration and saving<br/>[custom-fields.php]"]
  node_fieldrender["Field controls and sanitizing<br/>[renderers.php]"]
  node_adminjs["Admin media and repeaters<br/>[admin.js]"]
end

subgraph group_theme["Theme shell"]
  node_bootstrap["Module loading<br/>[functions.php]"]
  node_setup["Theme setup<br/>[setup.php]"]
  node_header["Header and menu<br/>[header.php]"]
  node_footer["Contacts and footer<br/>[footer.php]"]
  node_styles["Public styling<br/>[theme.css]"]
  node_publicjs["Public behaviors<br/>[theme.js]"]
end

subgraph group_views["Public views"]
  node_home["Home and featured services<br/>[page-home.php]"]
  node_cards["Reusable content card<br/>[content-card.php]"]
  node_serviceviews["Service archive and detail"]
  node_generalviews["General page and post<br/>[page.php]"]
  node_archiveviews["Archives and fallback<br/>[archive.php]"]
  node_searchview["Search results<br/>[search.php]"]
  node_taxonomyview["Taxonomy listing<br/>[taxonomy.php]"]
  node_notfound["Not found<br/>[404.php]"]
  node_breadcrumb["Breadcrumb navigation<br/>[breadcrumb.php]"]
end

node_administrator(("Administrator"))
node_visitor(("Site visitor"))
node_wordpress[("WordPress content store")]

node_bootstrap -->|"loads module"| node_setup
node_bootstrap -->|"loads module"| node_types
node_bootstrap -->|"loads module"| node_fieldadmin
node_setup -->|"enqueues"| node_styles
node_setup -->|"enqueues"| node_publicjs
node_setup -->|"limits archive"| node_types
node_administrator -->|"edits fields"| node_fieldadmin
node_types -->|"registers content types"| node_wordpress
node_fieldadmin -->|"reads definitions"| node_fieldconfig
node_fieldadmin -->|"renders controls"| node_fieldrender
node_fieldadmin -->|"saves post meta"| node_wordpress
node_fieldadmin -->|"enqueues admin script"| node_adminjs
node_adminjs -->|"selects media"| node_wordpress
node_footer -->|"reads contacts"| node_helpers
node_home -->|"reads fields"| node_helpers
node_home -->|"queries featured services"| node_wordpress
node_home -->|"renders cards"| node_cards
node_archiveviews -->|"renders cards"| node_cards
node_home -->|"renders shell"| node_header
node_home -->|"renders shell"| node_footer
node_generalviews -->|"renders shell"| node_header
node_generalviews -->|"renders shell"| node_footer
node_archiveviews -->|"renders navigation"| node_breadcrumb
node_generalviews -->|"renders navigation"| node_breadcrumb
node_visitor -.->|"views page"| node_home
node_visitor -.->|"views services"| node_serviceviews
node_visitor -.->|"views pages"| node_generalviews
node_visitor -.->|"searches content"| node_searchview
node_visitor -.->|"browses terms"| node_taxonomyview
node_visitor -.->|"requests missing page"| node_notfound

click node_bootstrap "https://github.com/rgrapha/novanix/blob/main/functions.php"
click node_setup "https://github.com/rgrapha/novanix/blob/main/inc/setup.php"
click node_header "https://github.com/rgrapha/novanix/blob/main/header.php"
click node_footer "https://github.com/rgrapha/novanix/blob/main/footer.php"
click node_styles "https://github.com/rgrapha/novanix/blob/main/assets/css/theme.css"
click node_publicjs "https://github.com/rgrapha/novanix/blob/main/assets/js/theme.js"
click node_types "https://github.com/rgrapha/novanix/blob/main/inc/custom-posts.php"
click node_fieldconfig "https://github.com/rgrapha/novanix/blob/main/inc/metabox/config.php"
click node_fieldadmin "https://github.com/rgrapha/novanix/blob/main/inc/custom-fields.php"
click node_fieldrender "https://github.com/rgrapha/novanix/blob/main/inc/metabox/renderers.php"
click node_adminjs "https://github.com/rgrapha/novanix/blob/main/inc/metabox/admin.js"
click node_helpers "https://github.com/rgrapha/novanix/blob/main/inc/helpers.php"
click node_home "https://github.com/rgrapha/novanix/blob/main/templates/page-home.php"
click node_cards "https://github.com/rgrapha/novanix/blob/main/templates/content-card.php"
click node_serviceviews "https://github.com/rgrapha/novanix/blob/main/archive-servicos.php"
click node_generalviews "https://github.com/rgrapha/novanix/blob/main/page.php"
click node_archiveviews "https://github.com/rgrapha/novanix/blob/main/archive.php"
click node_searchview "https://github.com/rgrapha/novanix/blob/main/search.php"
click node_taxonomyview "https://github.com/rgrapha/novanix/blob/main/taxonomy.php"
click node_notfound "https://github.com/rgrapha/novanix/blob/main/404.php"
click node_breadcrumb "https://github.com/rgrapha/novanix/blob/main/templates/breadcrumb.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_types,node_helpers toneBlue
class node_fieldconfig,node_fieldadmin,node_fieldrender,node_adminjs,node_wordpress toneAmber
class node_bootstrap,node_setup,node_header,node_footer,node_styles,node_publicjs toneMint
class node_home,node_cards,node_serviceviews,node_generalviews,node_archiveviews,node_searchview,node_taxonomyview,node_notfound,node_breadcrumb toneRose
class node_administrator,node_visitor toneIndigo
```

## Components

### Content and templates

- [Services and taxonomies](https://github.com/rgrapha/novanix/blob/main/inc/custom-posts.php): `inc/custom-posts.php`
- [Field and contact helpers](https://github.com/rgrapha/novanix/blob/main/inc/helpers.php): `inc/helpers.php`

### Fields and administration

- [Field definitions](https://github.com/rgrapha/novanix/blob/main/inc/metabox/config.php): `inc/metabox/config.php`
- [Field registration and saving](https://github.com/rgrapha/novanix/blob/main/inc/custom-fields.php): `inc/custom-fields.php`
- [Field controls and sanitizing](https://github.com/rgrapha/novanix/blob/main/inc/metabox/renderers.php): `inc/metabox/renderers.php`
- [Admin media and repeaters](https://github.com/rgrapha/novanix/blob/main/inc/metabox/admin.js): `inc/metabox/admin.js`

### Theme shell

- [Module loading](https://github.com/rgrapha/novanix/blob/main/functions.php): `functions.php`
- [Theme setup](https://github.com/rgrapha/novanix/blob/main/inc/setup.php): `inc/setup.php`
- [Header and menu](https://github.com/rgrapha/novanix/blob/main/header.php): `header.php`
- [Contacts and footer](https://github.com/rgrapha/novanix/blob/main/footer.php): `footer.php`
- [Public styling](https://github.com/rgrapha/novanix/blob/main/assets/css/theme.css): `assets/css/theme.css`
- [Public behaviors](https://github.com/rgrapha/novanix/blob/main/assets/js/theme.js): `assets/js/theme.js`

### Public views

- [Home and featured services](https://github.com/rgrapha/novanix/blob/main/templates/page-home.php): `templates/page-home.php`
- [Reusable content card](https://github.com/rgrapha/novanix/blob/main/templates/content-card.php): `templates/content-card.php`
- [Service archive and detail](https://github.com/rgrapha/novanix/blob/main/archive-servicos.php): `archive-servicos.php`
- [General page and post](https://github.com/rgrapha/novanix/blob/main/page.php): `page.php`
- [Archives and fallback](https://github.com/rgrapha/novanix/blob/main/archive.php): `archive.php`
- [Search results](https://github.com/rgrapha/novanix/blob/main/search.php): `search.php`
- [Taxonomy listing](https://github.com/rgrapha/novanix/blob/main/taxonomy.php): `taxonomy.php`
- [Not found](https://github.com/rgrapha/novanix/blob/main/404.php): `404.php`
- [Breadcrumb navigation](https://github.com/rgrapha/novanix/blob/main/templates/breadcrumb.php): `templates/breadcrumb.php`

### Other components

- **Administrator**
- **Site visitor**
- **WordPress content store**

## Connections

- Module loading → Theme setup: loads module (evidence: `README.md`)
- Module loading → Services and taxonomies: loads module (evidence: `README.md`)
- Module loading → Field registration and saving: loads module (evidence: `README.md`)
- Theme setup → Public styling: enqueues (evidence: `inc/setup.php`)
- Theme setup → Public behaviors: enqueues (evidence: `inc/setup.php`)
- Theme setup → Services and taxonomies: limits archive (evidence: `inc/setup.php`)
- Administrator → Field registration and saving: edits fields (evidence: `README.md`)
- Services and taxonomies → WordPress content store: registers content types (evidence: `inc/custom-posts.php`)
- Field registration and saving → Field definitions: reads definitions (evidence: `inc/custom-fields.php`)
- Field registration and saving → Field controls and sanitizing: renders controls (evidence: `inc/custom-fields.php`)
- Field registration and saving → WordPress content store: saves post meta (evidence: `inc/custom-fields.php`)
- Field registration and saving → Admin media and repeaters: enqueues admin script (evidence: `inc/custom-fields.php`)
- Admin media and repeaters → WordPress content store: selects media (evidence: `inc/metabox/admin.js`)
- Contacts and footer → Field and contact helpers: reads contacts (evidence: `footer.php`)
- Home and featured services → Field and contact helpers: reads fields (evidence: `templates/page-home.php`)
- Home and featured services → WordPress content store: queries featured services (evidence: `templates/page-home.php`)
- Home and featured services → Reusable content card: renders cards (evidence: `templates/page-home.php`)
- Archives and fallback → Reusable content card: renders cards
- Home and featured services → Header and menu: renders shell (evidence: `templates/page-home.php`)
- Home and featured services → Contacts and footer: renders shell (evidence: `templates/page-home.php`)
- General page and post → Header and menu: renders shell (evidence: `page.php`)
- General page and post → Contacts and footer: renders shell (evidence: `page.php`)
- Archives and fallback → Breadcrumb navigation: renders navigation
- General page and post → Breadcrumb navigation: renders navigation (evidence: `page.php`)
- Site visitor → Home and featured services: views page (evidence: `README.md`)
- Site visitor → Service archive and detail: views services (evidence: `README.md`)
- Site visitor → General page and post: views pages (evidence: `README.md`)
- Site visitor → Search results: searches content (evidence: `README.md`)
- Site visitor → Taxonomy listing: browses terms (evidence: `README.md`)
- Site visitor → Not found: requests missing page (evidence: `README.md`)
