# mbuguanewton/mnml-cms architecture

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

- Interactive diagram: https://gitdiagram.com/mbuguanewton/mnml-cms
- Repository: https://github.com/mbuguanewton/mnml-cms

## Overview

mnml-cms is a configurable content-management package: a site defines collections and fields, editors manage entries and media, and server readers expose content to the site. The main workflow runs from schema definition through the admin UI and route handlers to content services, a store, and persistence; publishing, drafts, preview, authentication, rich text, and agent access are distinct branches. Several subsystem links are supported only by the source index or documentation-level descriptions, so uncertain connections are omitted rather than inferred.

Main entry points: [`packages/cms/src/server/context.ts`](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/context.ts) (CMS context), [`packages/cms/src/server/storage.ts`](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/storage.ts) (Storage adapter), [`packages/cms/src/server/mcp-tools.ts`](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/mcp-tools.ts) (MCP content tools), [`packages/cms/src/server/handlers.ts`](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/handlers.ts) (Route handlers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_schema["Schema and editing"]
  node_schema_def["CMS definitions<br/>[define.ts]"]
  node_editor_config["Editor configuration<br/>[editor.ts]"]
  node_rich_text["Rich text tools"]
  node_markdown["Markdown conversion<br/>[markdown.ts]"]
end

subgraph group_admin["Admin experience"]
  node_admin_page["Admin page<br/>[admin-page.tsx]"]
  node_entry_forms["Entry forms<br/>[entry-form.tsx]"]
  node_field_widgets["Field widgets<br/>[fields.tsx]"]
  node_admin_api["Admin API client<br/>[api.ts]"]
end

subgraph group_runtime["Server content runtime"]
  node_route_handlers["Route handlers<br/>[handlers.ts]"]
  node_context["CMS context<br/>[context.ts]"]
  node_auth["Admin authentication<br/>[auth.ts]"]
  node_sessions["Session codec<br/>[session.ts]"]
  node_content["Content services<br/>[content.ts]"]
  node_store["Entry store<br/>[store.ts]"]
  node_storage["Storage adapter<br/>[storage.ts]"]
  node_database[("Drizzle database<br/>[db.ts]")]
  node_reader["Site content reader<br/>[store.ts]"]
end

subgraph group_integrations["Media and agents"]
  node_sync["Content sync<br/>[sync.ts]"]
  node_media["Media storage<br/>[media.ts]"]
  node_remote_media["Remote image import<br/>[remote-media.ts]"]
  node_mcp["MCP interface<br/>[mcp.ts]"]
  node_mcp_tools["MCP content tools<br/>[mcp-tools.ts]"]
  node_docs_index["Documentation index<br/>[docs-index.ts]"]
end

node_site(("Site integrator"))
node_admin_user(("Admin user"))
node_agent(("AI agent"))

node_site -->|"defines content"| node_schema_def
node_schema_def -->|"types editor"| node_editor_config
node_schema_def -->|"shapes fields"| node_markdown
node_admin_user -.->|"opens"| node_admin_page
node_admin_page -->|"renders"| node_entry_forms
node_entry_forms -->|"renders fields"| node_field_widgets
node_entry_forms -->|"sends requests"| node_admin_api
node_rich_text -->|"uses extensions"| node_editor_config
node_route_handlers -->|"uses context"| node_context
node_route_handlers -->|"checks access"| node_auth
node_route_handlers -->|"dispatches edits"| node_content
node_context -->|"creates"| node_store
node_context -->|"configures"| node_storage
node_context -->|"creates codec"| node_sessions
node_context -->|"configures"| node_media
node_auth -->|"reads sessions"| node_sessions
node_auth -->|"reads auth state"| node_storage
node_content -->|"updates entries"| node_store
node_store -->|"reads and writes"| node_storage
node_storage -->|"queries tables"| node_database
node_site -.->|"reads published content"| node_reader
node_agent -.->|"requests tools"| node_mcp
node_mcp -->|"dispatches tools"| node_mcp_tools
node_mcp_tools -->|"reads content"| node_content
node_mcp_tools -->|"queries index"| node_docs_index
node_mcp_tools -->|"converts content"| node_markdown
node_remote_media -->|"stores images"| node_media
node_sync -.->|"syncs entries"| node_storage
node_sync -.->|"imports images"| node_remote_media

click node_schema_def "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/define.ts"
click node_editor_config "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/editor.ts"
click node_rich_text "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/admin/rich-text-editor.tsx"
click node_markdown "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/markdown.ts"
click node_admin_page "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/admin-page.tsx"
click node_entry_forms "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/admin/entry-form.tsx"
click node_field_widgets "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/admin/fields.tsx"
click node_admin_api "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/api.ts"
click node_route_handlers "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/handlers.ts"
click node_context "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/context.ts"
click node_auth "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/auth.ts"
click node_sessions "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/session.ts"
click node_content "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/content.ts"
click node_store "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/store.ts"
click node_storage "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/storage.ts"
click node_database "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/db.ts"
click node_reader "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/store.ts"
click node_sync "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/sync.ts"
click node_media "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/media.ts"
click node_remote_media "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/remote-media.ts"
click node_mcp "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/mcp.ts"
click node_mcp_tools "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/mcp-tools.ts"
click node_docs_index "https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/docs-index.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_schema_def,node_editor_config,node_rich_text,node_markdown,node_admin_user toneBlue
class node_admin_page,node_entry_forms,node_field_widgets,node_admin_api toneAmber
class node_route_handlers,node_context,node_auth,node_sessions,node_content,node_store,node_storage,node_database,node_reader toneMint
class node_sync,node_media,node_remote_media,node_mcp,node_mcp_tools,node_docs_index toneRose
class node_site,node_agent toneIndigo
```

## Components

### Schema and editing

- [CMS definitions](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/define.ts): `packages/cms/src/define.ts`
- [Editor configuration](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/editor.ts): `packages/cms/src/editor.ts`
- [Rich text tools](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/admin/rich-text-editor.tsx): `packages/cms/src/admin/rich-text-editor.tsx`
- [Markdown conversion](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/markdown.ts): `packages/cms/src/markdown.ts`

### Admin experience

- [Admin page](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/admin-page.tsx): `packages/cms/src/server/admin-page.tsx`
- [Entry forms](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/admin/entry-form.tsx): `packages/cms/src/admin/entry-form.tsx`
- [Field widgets](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/admin/fields.tsx): `packages/cms/src/admin/fields.tsx`
- [Admin API client](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/api.ts): `packages/cms/src/api.ts`

### Server content runtime

- [Route handlers](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/handlers.ts): `packages/cms/src/server/handlers.ts`
- [CMS context](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/context.ts): `packages/cms/src/server/context.ts`
- [Admin authentication](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/auth.ts): `packages/cms/src/server/auth.ts`
- [Session codec](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/session.ts): `packages/cms/src/server/session.ts`
- [Content services](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/content.ts): `packages/cms/src/server/content.ts`
- [Entry store](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/store.ts): `packages/cms/src/server/store.ts`
- [Storage adapter](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/storage.ts): `packages/cms/src/server/storage.ts`
- [Drizzle database](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/db.ts): `packages/cms/src/server/db.ts`
- [Site content reader](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/store.ts): `packages/cms/src/server/store.ts`

### Media and agents

- [Content sync](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/sync.ts): `packages/cms/src/sync.ts`
- [Media storage](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/media.ts): `packages/cms/src/server/media.ts`
- [Remote image import](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/remote-media.ts): `packages/cms/src/remote-media.ts`
- [MCP interface](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/mcp.ts): `packages/cms/src/server/mcp.ts`
- [MCP content tools](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/mcp-tools.ts): `packages/cms/src/server/mcp-tools.ts`
- [Documentation index](https://github.com/mbuguanewton/mnml-cms/blob/main/packages/cms/src/server/docs-index.ts): `packages/cms/src/server/docs-index.ts`

### Other components

- **Site integrator**
- **Admin user**
- **AI agent**

## Connections

- Site integrator → CMS definitions: defines content (evidence: `packages/cms/src/define.ts`)
- CMS definitions → Editor configuration: types editor (evidence: `packages/cms/src/editor.ts`)
- CMS definitions → Markdown conversion: shapes fields (evidence: `packages/cms/src/markdown.ts`)
- Admin user → Admin page: opens
- Admin page → Entry forms: renders (evidence: `packages/cms/src/server/admin-page.tsx`)
- Entry forms → Field widgets: renders fields (evidence: `packages/cms/src/admin/entry-form.tsx`)
- Entry forms → Admin API client: sends requests (evidence: `packages/cms/src/admin/entry-form.tsx`)
- Rich text tools → Editor configuration: uses extensions (evidence: `packages/cms/src/admin/rich-text-editor.tsx`)
- Route handlers → CMS context: uses context (evidence: `packages/cms/src/server/handlers.ts`)
- Route handlers → Admin authentication: checks access (evidence: `packages/cms/src/server/handlers.ts`)
- Route handlers → Content services: dispatches edits (evidence: `packages/cms/src/server/handlers.ts`)
- CMS context → Entry store: creates (evidence: `packages/cms/src/server/context.ts`)
- CMS context → Storage adapter: configures (evidence: `packages/cms/src/server/context.ts`)
- CMS context → Session codec: creates codec (evidence: `packages/cms/src/server/context.ts`)
- CMS context → Media storage: configures (evidence: `packages/cms/src/server/context.ts`)
- Admin authentication → Session codec: reads sessions (evidence: `packages/cms/src/server/auth.ts`)
- Admin authentication → Storage adapter: reads auth state (evidence: `packages/cms/src/server/auth.ts`)
- Content services → Entry store: updates entries (evidence: `packages/cms/src/server/content.ts`)
- Entry store → Storage adapter: reads and writes (evidence: `packages/cms/src/server/store.ts`)
- Storage adapter → Drizzle database: queries tables (evidence: `packages/cms/src/server/storage.ts`)
- Site integrator → Site content reader: reads published content
- AI agent → MCP interface: requests tools
- MCP interface → MCP content tools: dispatches tools (evidence: `packages/cms/src/server/mcp.ts`)
- MCP content tools → Content services: reads content (evidence: `packages/cms/src/server/mcp-tools.ts`)
- MCP content tools → Documentation index: queries index (evidence: `packages/cms/src/server/mcp-tools.ts`)
- MCP content tools → Markdown conversion: converts content (evidence: `packages/cms/src/server/mcp-tools.ts`)
- Remote image import → Media storage: stores images (evidence: `packages/cms/src/remote-media.ts`)
- Content sync → Storage adapter: syncs entries (evidence: `packages/cms/src/sync.ts`)
- Content sync → Remote image import: imports images (evidence: `packages/cms/src/sync.ts`)
