# decaporg/decap-cms architecture

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

- Interactive diagram: https://gitdiagram.com/decaporg/decap-cms
- Repository: https://github.com/decaporg/decap-cms

## Overview

Decap CMS is a browser-based content management app for editing static-site content stored in Git. A user opens the admin app, authenticates, selects a collection, edits or creates an entry, and saves or publishes it through a configured Git backend. The product also supports editorial workflow, media libraries, configurable editor widgets, localization, and integrations. The map emphasizes these documented capabilities and the principal UI-to-backend stages; unsampled provider and feature wiring is shown only where documentation supports it.

Main entry points: [`packages/decap-cms-core/src/backend.ts`](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/backend.ts) (Backend adapter), [`packages/decap-cms-core/src/components/App/App.js`](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/components/App/App.js) (Admin app), [`packages/decap-cms-core/src/components/Editor/Editor.js`](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/components/Editor/Editor.js) (Entry editor), [`packages/decap-cms-core/src/actions/mediaLibrary.ts`](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/actions/mediaLibrary.ts) (Media library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Admin application"]
  node_app["Admin app<br/>[App.js]"]
end

subgraph group_content["Content editing"]
  node_collections["Collection browser<br/>[Collection.js]"]
  node_editor["Entry editor<br/>[Editor.js]"]
  node_editorinterface["Editor interface<br/>[EditorInterface.js]"]
  node_widgets["Editor widgets<br/>[index.js]"]
  node_markdown["Markdown editor<br/>[MarkdownPreview.js]"]
  node_richtext["Rich-text serializers<br/>[index.js]"]
  node_workflow["Editorial workflow"]
  node_mediaui["Media browser<br/>[MediaLibrary.js]"]
end

subgraph group_services["CMS services"]
  node_auth["Login actions<br/>[auth.ts]"]
  node_entryactions["Entry actions<br/>[entries.ts]"]
  node_backend["Backend adapter<br/>[backend.ts]"]
  node_authactions["Backend login<br/>[auth.ts]"]
  node_state[("CMS state<br/>[entries.ts]")]
  node_media["Media library<br/>[mediaLibrary.ts]"]
  node_asset["Asset references<br/>[AssetProxy.ts]"]
  node_locales["Translations<br/>[index.js]"]
  node_integrations["Integrations<br/>[index.js]"]
end

subgraph group_connectors["Backend connectors"]
  node_authui["Authentication UI"]
  node_gitgithub["GitHub backend<br/>[implementation.tsx]"]
  node_gitlab["GitLab backend<br/>[implementation.ts]"]
  node_gitgateway["Git Gateway<br/>[implementation.ts]"]
  node_otherbackends["Other Git backends<br/>[implementation.ts]"]
end

node_user(("CMS user"))
node_repository[("Git repository")]

node_user -->|"opens admin"| node_app
node_app -->|"prompts login"| node_authui
node_app -->|"submits credentials"| node_auth
node_app -->|"routes to"| node_collections
node_app -->|"routes to"| node_editor
node_collections -->|"dispatches entry actions"| node_entryactions
node_editor -->|"loads and saves"| node_entryactions
node_editor -->|"renders"| node_editorinterface
node_editorinterface -.->|"renders fields"| node_widgets
node_widgets -.->|"resolves widget"| node_markdown
node_richtext -.->|"serializes content"| node_markdown
node_editor -->|"dispatches workflow"| node_workflow
node_auth -->|"uses backend"| node_backend
node_entryactions -.->|"loads and persists"| node_backend
node_backend -.->|"delegates Git operations"| node_gitgithub
node_backend -.->|"delegates Git operations"| node_gitlab
node_backend -.->|"delegates Git operations"| node_gitgateway
node_backend -.->|"delegates Git operations"| node_otherbackends
node_gitgithub -.->|"reads and writes"| node_repository
node_mediaui -.->|"manages assets"| node_media
node_media -.->|"persists media"| node_backend
node_media -->|"creates references"| node_asset
node_collections -->|"selects collection state"| node_state
node_editor -->|"reads editor state"| node_state
node_app -.->|"displays translations"| node_locales
node_media -->|"checks integration"| node_integrations

click node_app "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/components/App/App.js"
click node_auth "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/actions/auth.ts"
click node_authui "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-ui-auth/src/PKCEAuthenticationPage.js"
click node_collections "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/components/Collection/Collection.js"
click node_entryactions "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/actions/entries.ts"
click node_editor "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/components/Editor/Editor.js"
click node_editorinterface "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/components/Editor/EditorInterface.js"
click node_widgets "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/components/EditorWidgets/index.js"
click node_markdown "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-widget-markdown/src/MarkdownPreview.js"
click node_richtext "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-widget-richtext/src/serializers/index.js"
click node_workflow "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/actions/editorialWorkflow.ts"
click node_backend "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/backend.ts"
click node_authactions "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/actions/auth.ts"
click node_gitgithub "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-backend-github/src/implementation.tsx"
click node_gitlab "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-backend-gitlab/src/implementation.ts"
click node_gitgateway "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-backend-git-gateway/src/implementation.ts"
click node_otherbackends "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-backend-bitbucket/src/implementation.ts"
click node_state "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/reducers/entries.ts"
click node_media "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/actions/mediaLibrary.ts"
click node_mediaui "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/components/MediaLibrary/MediaLibrary.js"
click node_asset "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/valueObjects/AssetProxy.ts"
click node_locales "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-locales/src/index.js"
click node_integrations "https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/integrations/index.js"

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_app,node_user toneBlue
class node_collections,node_editor,node_editorinterface,node_widgets,node_markdown,node_richtext,node_workflow,node_mediaui,node_repository toneAmber
class node_auth,node_entryactions,node_backend,node_authactions,node_state,node_media,node_asset,node_locales,node_integrations toneMint
class node_authui,node_gitgithub,node_gitlab,node_gitgateway,node_otherbackends toneRose
```

## Components

### Admin application

- [Admin app](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/components/App/App.js): `packages/decap-cms-core/src/components/App/App.js`

### Content editing

- [Collection browser](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/components/Collection/Collection.js): `packages/decap-cms-core/src/components/Collection/Collection.js`
- [Entry editor](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/components/Editor/Editor.js): `packages/decap-cms-core/src/components/Editor/Editor.js`
- [Editor interface](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/components/Editor/EditorInterface.js): `packages/decap-cms-core/src/components/Editor/EditorInterface.js`
- [Editor widgets](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/components/EditorWidgets/index.js): `packages/decap-cms-core/src/components/EditorWidgets/index.js`
- [Markdown editor](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-widget-markdown/src/MarkdownPreview.js): `packages/decap-cms-widget-markdown/src/MarkdownPreview.js`
- [Rich-text serializers](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-widget-richtext/src/serializers/index.js): `packages/decap-cms-widget-richtext/src/serializers/index.js`
- [Editorial workflow](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/actions/editorialWorkflow.ts): `packages/decap-cms-core/src/actions/editorialWorkflow.ts`
- [Media browser](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/components/MediaLibrary/MediaLibrary.js): `packages/decap-cms-core/src/components/MediaLibrary/MediaLibrary.js`

### CMS services

- [Login actions](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/actions/auth.ts): `packages/decap-cms-core/src/actions/auth.ts`
- [Entry actions](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/actions/entries.ts): `packages/decap-cms-core/src/actions/entries.ts`
- [Backend adapter](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/backend.ts): `packages/decap-cms-core/src/backend.ts`
- [Backend login](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/actions/auth.ts): `packages/decap-cms-core/src/actions/auth.ts`
- [CMS state](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/reducers/entries.ts): `packages/decap-cms-core/src/reducers/entries.ts`
- [Media library](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/actions/mediaLibrary.ts): `packages/decap-cms-core/src/actions/mediaLibrary.ts`
- [Asset references](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/valueObjects/AssetProxy.ts): `packages/decap-cms-core/src/valueObjects/AssetProxy.ts`
- [Translations](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-locales/src/index.js): `packages/decap-cms-locales/src/index.js`
- [Integrations](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-core/src/integrations/index.js): `packages/decap-cms-core/src/integrations/index.js`

### Backend connectors

- [Authentication UI](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-ui-auth/src/PKCEAuthenticationPage.js): `packages/decap-cms-ui-auth/src/PKCEAuthenticationPage.js`
- [GitHub backend](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-backend-github/src/implementation.tsx): `packages/decap-cms-backend-github/src/implementation.tsx`
- [GitLab backend](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-backend-gitlab/src/implementation.ts): `packages/decap-cms-backend-gitlab/src/implementation.ts`
- [Git Gateway](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-backend-git-gateway/src/implementation.ts): `packages/decap-cms-backend-git-gateway/src/implementation.ts`
- [Other Git backends](https://github.com/decaporg/decap-cms/blob/main/packages/decap-cms-backend-bitbucket/src/implementation.ts): `packages/decap-cms-backend-bitbucket/src/implementation.ts`

### Other components

- **CMS user**
- **Git repository**

## Connections

- CMS user → Admin app: opens admin (evidence: `README.md`)
- Admin app → Authentication UI: prompts login (evidence: `packages/decap-cms-core/src/components/App/App.js`)
- Admin app → Login actions: submits credentials (evidence: `packages/decap-cms-core/src/components/App/App.js`)
- Admin app → Collection browser: routes to (evidence: `packages/decap-cms-core/src/components/App/App.js`)
- Admin app → Entry editor: routes to (evidence: `packages/decap-cms-core/src/components/App/App.js`)
- Collection browser → Entry actions: dispatches entry actions (evidence: `packages/decap-cms-core/src/components/Collection/Collection.js`)
- Entry editor → Entry actions: loads and saves (evidence: `packages/decap-cms-core/src/components/Editor/Editor.js`)
- Entry editor → Editor interface: renders (evidence: `packages/decap-cms-core/src/components/Editor/Editor.js`)
- Editor interface → Editor widgets: renders fields
- Editor widgets → Markdown editor: resolves widget
- Rich-text serializers → Markdown editor: serializes content
- Entry editor → Editorial workflow: dispatches workflow (evidence: `packages/decap-cms-core/src/components/Editor/Editor.js`)
- Login actions → Backend adapter: uses backend (evidence: `packages/decap-cms-core/src/actions/auth.ts`)
- Entry actions → Backend adapter: loads and persists
- Backend adapter → GitHub backend: delegates Git operations
- Backend adapter → GitLab backend: delegates Git operations
- Backend adapter → Git Gateway: delegates Git operations
- Backend adapter → Other Git backends: delegates Git operations
- GitHub backend → Git repository: reads and writes
- Media browser → Media library: manages assets (evidence: `packages/decap-cms-core/src/components/MediaLibrary/MediaLibrary.js`)
- Media library → Backend adapter: persists media (evidence: `packages/decap-cms-core/src/actions/mediaLibrary.ts`)
- Media library → Asset references: creates references (evidence: `packages/decap-cms-core/src/actions/mediaLibrary.ts`)
- Collection browser → CMS state: selects collection state (evidence: `packages/decap-cms-core/src/components/Collection/Collection.js`)
- Entry editor → CMS state: reads editor state (evidence: `packages/decap-cms-core/src/components/Editor/Editor.js`)
- Admin app → Translations: displays translations
- Media library → Integrations: checks integration (evidence: `packages/decap-cms-core/src/actions/mediaLibrary.ts`)
