How mbuguanewton/mnml-cms works
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: context.ts CMS context · storage.ts Storage adapter · mcp-tools.ts MCP content tools · handlers.ts Route handlers
Components 26
Schema and editing
- CMS definitions
packages/cms/src/define.ts - Editor configuration
packages/cms/src/editor.ts - Rich text tools
packages/cms/src/admin/rich-text-editor.tsx - Markdown conversion
packages/cms/src/markdown.ts
Admin experience
- Admin page
packages/cms/src/server/admin-page.tsx - Entry forms
packages/cms/src/admin/entry-form.tsx - Field widgets
packages/cms/src/admin/fields.tsx - Admin API client
packages/cms/src/api.ts
Server content runtime
- Route handlers
packages/cms/src/server/handlers.ts - CMS context
packages/cms/src/server/context.ts - Admin authentication
packages/cms/src/server/auth.ts - Session codec
packages/cms/src/server/session.ts - Content services
packages/cms/src/server/content.ts - Entry store
packages/cms/src/server/store.ts - Storage adapter
packages/cms/src/server/storage.ts - Drizzle database
packages/cms/src/server/db.ts - Site content reader
packages/cms/src/server/store.ts
Media and agents
- Content sync
packages/cms/src/sync.ts - Media storage
packages/cms/src/server/media.ts - Remote image import
packages/cms/src/remote-media.ts - MCP interface
packages/cms/src/server/mcp.ts - MCP content tools
packages/cms/src/server/mcp-tools.ts - Documentation index
packages/cms/src/server/docs-index.ts
Other components
- Site integrator
- Admin user
- AI agent
Connections 29
- Site integrator → CMS definitions: defines content
packages/cms/src/define.ts - CMS definitions → Editor configuration: types editor
packages/cms/src/editor.ts - CMS definitions → Markdown conversion: shapes fields
packages/cms/src/markdown.ts - Admin user → Admin page: opens
- Admin page → Entry forms: renders
packages/cms/src/server/admin-page.tsx - Entry forms → Field widgets: renders fields
packages/cms/src/admin/entry-form.tsx - Entry forms → Admin API client: sends requests
packages/cms/src/admin/entry-form.tsx - Rich text tools → Editor configuration: uses extensions
packages/cms/src/admin/rich-text-editor.tsx - Route handlers → CMS context: uses context
packages/cms/src/server/handlers.ts - Route handlers → Admin authentication: checks access
packages/cms/src/server/handlers.ts - Route handlers → Content services: dispatches edits
packages/cms/src/server/handlers.ts - CMS context → Entry store: creates
packages/cms/src/server/context.ts - CMS context → Storage adapter: configures
packages/cms/src/server/context.ts - CMS context → Session codec: creates codec
packages/cms/src/server/context.ts - CMS context → Media storage: configures
packages/cms/src/server/context.ts - Admin authentication → Session codec: reads sessions
packages/cms/src/server/auth.ts - Admin authentication → Storage adapter: reads auth state
packages/cms/src/server/auth.ts - Content services → Entry store: updates entries
packages/cms/src/server/content.ts - Entry store → Storage adapter: reads and writes
packages/cms/src/server/store.ts - Storage adapter → Drizzle database: queries tables
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
packages/cms/src/server/mcp.ts - MCP content tools → Content services: reads content
packages/cms/src/server/mcp-tools.ts - MCP content tools → Documentation index: queries index
packages/cms/src/server/mcp-tools.ts - MCP content tools → Markdown conversion: converts content
packages/cms/src/server/mcp-tools.ts - Remote image import → Media storage: stores images
packages/cms/src/remote-media.ts - Content sync → Storage adapter: syncs entries
packages/cms/src/sync.ts - Content sync → Remote image import: imports images
packages/cms/src/sync.ts