# jaimemartinez/wordjs architecture

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

## Overview

WordJS is a full website CMS: administrators and authors configure a site, create pages with the built-in visual editor, and publish them for visitors through SEO-ready rendered pages and feeds. Its backend supplies content, media, themes, and extensions; plugins run behind a permission-controlled OS sandbox. The map preserves documented capabilities including import, multisite, integrations, and operations. Some subsystem paths are represented by exact directories because their individual implementations were not sampled; edges are limited to README claims or indexed imports.

Main entry points: [`backend/src/routes`](https://github.com/jaimemartinez/wordjs/tree/main/backend/src/routes) (Content and API routes), [`frontend/src/app/admin`](https://github.com/jaimemartinez/wordjs/tree/main/frontend/src/app/admin) (Admin workspace), [`backend/src/index.ts`](https://github.com/jaimemartinez/wordjs/blob/main/backend/src/index.ts) (Backend application), [`backend/src/core/plugin-isolate.ts`](https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/plugin-isolate.ts) (Plugin sandbox)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Authoring and design"]
  node_admin_ui["Admin workspace"]
  node_verso["Verso editor<br/>[IxCanvasEngine.tsx]"]
  node_theme_engine["Theme engine<br/>[theme-engine.ts]"]
end

subgraph group_publishing["Public publishing"]
  node_public_pages["Public pages"]
  node_seo_feeds["SEO and feeds"]
end

subgraph group_extensions["Plugin ecosystem"]
  node_plugin_admin["Plugin management<br/>[plugins.ts]"]
  node_plugin_sandbox["Plugin sandbox<br/>[plugin-isolate.ts]"]
  node_plugin_permissions["Plugin permissions"]
  node_hooks["Hooks and filters<br/>[hooks.ts]"]
end

subgraph group_platform["Backend platform"]
  node_backend_entry["Backend application<br/>[index.ts]"]
  node_api_routes["Content and API routes"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_content_models["Content models"]
  node_database[("Database layer<br/>[database.ts]")]
  node_media["Media storage<br/>[media-storage.ts]"]
  node_wp_import["WordPress importer<br/>[wxr-import.ts]"]
end

subgraph group_operations["Operations and integrations"]
  node_gateway["Cluster gateway<br/>[index.js]"]
  node_mcp["MCP and GraphQL"]
  node_webhooks["Webhooks<br/>[webhooks.ts]"]
  node_multisite["Multisite context<br/>[site-context.ts]"]
end

node_admin(("Site administrator"))
node_visitor(("Site visitor"))

node_admin -->|"manages site"| node_admin_ui
node_admin_ui -->|"edits pages"| node_verso
node_verso -.->|"publishes content"| node_backend_entry
node_backend_entry -->|"mounts routes"| node_api_routes
node_api_routes -->|"authenticates requests"| node_auth
node_api_routes -.->|"serves content"| node_content_models
node_content_models -.->|"persists content"| node_database
node_backend_entry -.->|"serves website"| node_public_pages
node_visitor -->|"views pages"| node_public_pages
node_public_pages -->|"renders SEO surfaces"| node_seo_feeds
node_api_routes -->|"manages media"| node_media
node_admin_ui -.->|"imports WordPress"| node_wp_import
node_admin_ui -->|"installs plugins"| node_plugin_admin
node_plugin_admin -->|"starts isolated process"| node_plugin_sandbox
node_plugin_sandbox -->|"checks capabilities"| node_plugin_permissions
node_plugin_sandbox -.->|"uses host hooks"| node_hooks
node_admin_ui -.->|"customizes theme"| node_theme_engine
node_gateway -.->|"proxies requests"| node_backend_entry
node_api_routes -.->|"exposes APIs"| node_mcp
node_api_routes -.->|"manages webhooks"| node_webhooks
node_backend_entry -->|"resolves site context"| node_multisite

click node_admin_ui "https://github.com/jaimemartinez/wordjs/tree/main/frontend/src/app/admin"
click node_verso "https://github.com/jaimemartinez/wordjs/blob/main/frontend/src/components/verso/canvas/IxCanvasEngine.tsx"
click node_theme_engine "https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/theme-engine.ts"
click node_public_pages "https://github.com/jaimemartinez/wordjs/tree/main/frontend/src/app/(public)"
click node_seo_feeds "https://github.com/jaimemartinez/wordjs/tree/main/frontend/src/app/(public)"
click node_backend_entry "https://github.com/jaimemartinez/wordjs/blob/main/backend/src/index.ts"
click node_api_routes "https://github.com/jaimemartinez/wordjs/tree/main/backend/src/routes"
click node_auth "https://github.com/jaimemartinez/wordjs/blob/main/backend/src/middleware/auth.ts"
click node_content_models "https://github.com/jaimemartinez/wordjs/tree/main/backend/src/models"
click node_database "https://github.com/jaimemartinez/wordjs/blob/main/backend/src/config/database.ts"
click node_media "https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/media-storage.ts"
click node_wp_import "https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/wxr-import.ts"
click node_plugin_admin "https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/plugins.ts"
click node_plugin_sandbox "https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/plugin-isolate.ts"
click node_plugin_permissions "https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/plugin-permissions.ts"
click node_hooks "https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/hooks.ts"
click node_gateway "https://github.com/jaimemartinez/wordjs/blob/main/gateway/src/index.js"
click node_mcp "https://github.com/jaimemartinez/wordjs/tree/main/backend/src/routes"
click node_webhooks "https://github.com/jaimemartinez/wordjs/blob/main/backend/src/routes/webhooks.ts"
click node_multisite "https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/site-context.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_admin_ui,node_verso,node_theme_engine toneBlue
class node_public_pages,node_seo_feeds toneAmber
class node_plugin_admin,node_plugin_sandbox,node_plugin_permissions,node_hooks toneMint
class node_backend_entry,node_api_routes,node_auth,node_content_models,node_database,node_media,node_wp_import toneRose
class node_gateway,node_mcp,node_webhooks,node_multisite,node_admin,node_visitor toneIndigo
```

## Components

### Authoring and design

- [Admin workspace](https://github.com/jaimemartinez/wordjs/tree/main/frontend/src/app/admin): `frontend/src/app/admin`
- [Verso editor](https://github.com/jaimemartinez/wordjs/blob/main/frontend/src/components/verso/canvas/IxCanvasEngine.tsx): `frontend/src/components/verso/canvas/IxCanvasEngine.tsx`
- [Theme engine](https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/theme-engine.ts): `backend/src/core/theme-engine.ts`

### Public publishing

- [Public pages](https://github.com/jaimemartinez/wordjs/tree/main/frontend/src/app/(public)): `frontend/src/app/(public)`
- [SEO and feeds](https://github.com/jaimemartinez/wordjs/tree/main/frontend/src/app/(public)): `frontend/src/app/(public)`

### Plugin ecosystem

- [Plugin management](https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/plugins.ts): `backend/src/core/plugins.ts`
- [Plugin sandbox](https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/plugin-isolate.ts): `backend/src/core/plugin-isolate.ts`
- [Plugin permissions](https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/plugin-permissions.ts): `backend/src/core/plugin-permissions.ts`
- [Hooks and filters](https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/hooks.ts): `backend/src/core/hooks.ts`

### Backend platform

- [Backend application](https://github.com/jaimemartinez/wordjs/blob/main/backend/src/index.ts): `backend/src/index.ts`
- [Content and API routes](https://github.com/jaimemartinez/wordjs/tree/main/backend/src/routes): `backend/src/routes`
- [Authentication](https://github.com/jaimemartinez/wordjs/blob/main/backend/src/middleware/auth.ts): `backend/src/middleware/auth.ts`
- [Content models](https://github.com/jaimemartinez/wordjs/tree/main/backend/src/models): `backend/src/models`
- [Database layer](https://github.com/jaimemartinez/wordjs/blob/main/backend/src/config/database.ts): `backend/src/config/database.ts`
- [Media storage](https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/media-storage.ts): `backend/src/core/media-storage.ts`
- [WordPress importer](https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/wxr-import.ts): `backend/src/core/wxr-import.ts`

### Operations and integrations

- [Cluster gateway](https://github.com/jaimemartinez/wordjs/blob/main/gateway/src/index.js): `gateway/src/index.js`
- [MCP and GraphQL](https://github.com/jaimemartinez/wordjs/tree/main/backend/src/routes): `backend/src/routes`
- [Webhooks](https://github.com/jaimemartinez/wordjs/blob/main/backend/src/routes/webhooks.ts): `backend/src/routes/webhooks.ts`
- [Multisite context](https://github.com/jaimemartinez/wordjs/blob/main/backend/src/core/site-context.ts): `backend/src/core/site-context.ts`

### Other components

- **Site administrator**
- **Site visitor**

## Connections

- Site administrator → Admin workspace: manages site
- Admin workspace → Verso editor: edits pages
- Verso editor → Backend application: publishes content
- Backend application → Content and API routes: mounts routes (evidence: `backend/src/index.ts`)
- Content and API routes → Authentication: authenticates requests (evidence: `backend/src/routes/media-storage.ts`)
- Content and API routes → Content models: serves content
- Content models → Database layer: persists content (evidence: `backend/src/config/database.ts`)
- Backend application → Public pages: serves website
- Site visitor → Public pages: views pages
- Public pages → SEO and feeds: renders SEO surfaces
- Content and API routes → Media storage: manages media (evidence: `backend/src/routes/media-storage.ts`)
- Admin workspace → WordPress importer: imports WordPress
- Admin workspace → Plugin management: installs plugins
- Plugin management → Plugin sandbox: starts isolated process
- Plugin sandbox → Plugin permissions: checks capabilities
- Plugin sandbox → Hooks and filters: uses host hooks
- Admin workspace → Theme engine: customizes theme
- Cluster gateway → Backend application: proxies requests
- Content and API routes → MCP and GraphQL: exposes APIs
- Content and API routes → Webhooks: manages webhooks
- Backend application → Multisite context: resolves site context (evidence: `backend/src/index.ts`)
