# unctom/roundcubemail architecture

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

- Interactive diagram: https://gitdiagram.com/unctom/roundcubemail
- Repository: https://github.com/unctom/roundcubemail

## Overview

Roundcube is a browser-based multilingual IMAP webmail client. A user interacts with the web UI, whose requests enter through the PHP front controller; the application supports mail and folder operations, contacts, settings, and spell checking, with IMAP as its mail backend. Its plugin API extends the product, while a custom framework and database-backed services provide internal support. The README establishes the product capabilities; unsampled action wiring and backend calls are not asserted as verified.

Main entry points: [`public_html/index.php`](https://github.com/unctom/roundcubemail/blob/master/public_html/index.php) (HTTP front controller), [`program/actions/mail`](https://github.com/unctom/roundcubemail/tree/master/program/actions/mail) (Mail actions), [`plugins/markdown_editor/javascript/index.js`](https://github.com/unctom/roundcubemail/blob/master/plugins/markdown_editor/javascript/index.js) (Markdown editor), [`program/js/app.js`](https://github.com/unctom/roundcubemail/blob/master/program/js/app.js) (Browser UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry"]
  node_ui["Browser UI<br/>[app.js]"]
  node_front["HTTP front controller<br/>[index.php]"]
end

subgraph group_mail["Mail and contacts"]
  node_mailactions["Mail actions"]
  node_imap["IMAP storage<br/>[rcube_storage.php]"]
  node_contacts["Address book"]
  node_settings["Settings actions"]
end

subgraph group_framework["Application framework"]
  node_init["Runtime initialization<br/>[iniset.php]"]
  node_bootstrap["Framework bootstrap<br/>[bootstrap.php]"]
  node_spell["Spell-check interface<br/>[engine.php]"]
  node_pluginapi["Plugin API"]
end

subgraph group_extensions["Extensions"]
  node_markdown["Markdown editor<br/>[index.js]"]
  node_toolbar["Editor toolbar button<br/>[toolbar-button.js]"]
  node_toolbarplugin["Editor toolbar plugin<br/>[toolbar-plugin.js]"]
  node_enigma["PGP mail support<br/>[enigma_engine.php]"]
  node_sieve["Sieve filter editor"]
end

node_user(("Webmail user"))
node_database[("SQL database")]
node_sieveexternal["Sieve service"]

node_user -->|"uses"| node_ui
node_ui -.->|"sends requests"| node_front
node_front -->|"initializes via"| node_init
node_init -->|"loads"| node_bootstrap
node_front -.->|"dispatches"| node_mailactions
node_mailactions -.->|"uses for mail"| node_imap
node_user -.->|"manages contacts"| node_contacts
node_user -.->|"manages settings"| node_settings
node_user -.->|"checks spelling"| node_spell
node_mailactions -.->|"uses"| node_database
node_contacts -.->|"uses"| node_database
node_settings -.->|"uses"| node_database
node_front -.->|"runs plugin hooks"| node_pluginapi
node_user -.->|"edits messages"| node_markdown
node_markdown -->|"creates buttons"| node_toolbar
node_markdown -->|"imports"| node_toolbarplugin
node_user -.->|"uses PGP features"| node_enigma
node_user -.->|"manages filters"| node_sieve
node_sieve -.->|"accesses"| node_sieveexternal

click node_ui "https://github.com/unctom/roundcubemail/blob/master/program/js/app.js"
click node_front "https://github.com/unctom/roundcubemail/blob/master/public_html/index.php"
click node_init "https://github.com/unctom/roundcubemail/blob/master/program/include/iniset.php"
click node_bootstrap "https://github.com/unctom/roundcubemail/blob/master/program/lib/Roundcube/bootstrap.php"
click node_mailactions "https://github.com/unctom/roundcubemail/tree/master/program/actions/mail"
click node_imap "https://github.com/unctom/roundcubemail/blob/master/program/lib/Roundcube/rcube_storage.php"
click node_contacts "https://github.com/unctom/roundcubemail/tree/master/program/actions/contacts"
click node_settings "https://github.com/unctom/roundcubemail/tree/master/program/actions/settings"
click node_spell "https://github.com/unctom/roundcubemail/blob/master/program/lib/Roundcube/spellchecker/engine.php"
click node_pluginapi "https://github.com/unctom/roundcubemail/blob/master/program/lib/Roundcube/rcube_plugin_api.php"
click node_markdown "https://github.com/unctom/roundcubemail/blob/master/plugins/markdown_editor/javascript/index.js"
click node_toolbar "https://github.com/unctom/roundcubemail/blob/master/plugins/markdown_editor/javascript/toolbar-button.js"
click node_toolbarplugin "https://github.com/unctom/roundcubemail/blob/master/plugins/markdown_editor/javascript/toolbar-plugin.js"
click node_enigma "https://github.com/unctom/roundcubemail/blob/master/plugins/enigma/lib/enigma_engine.php"
click node_sieve "https://github.com/unctom/roundcubemail/blob/master/plugins/managesieve/lib/Roundcube/rcube_sieve_engine.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_ui,node_front,node_user toneBlue
class node_mailactions,node_imap,node_contacts,node_settings,node_database toneAmber
class node_init,node_bootstrap,node_spell,node_pluginapi toneMint
class node_markdown,node_toolbar,node_toolbarplugin,node_enigma,node_sieve toneRose
class node_sieveexternal toneIndigo
```

## Components

### Web entry

- [Browser UI](https://github.com/unctom/roundcubemail/blob/master/program/js/app.js): `program/js/app.js`
- [HTTP front controller](https://github.com/unctom/roundcubemail/blob/master/public_html/index.php): `public_html/index.php`

### Mail and contacts

- [Mail actions](https://github.com/unctom/roundcubemail/tree/master/program/actions/mail): `program/actions/mail`
- [IMAP storage](https://github.com/unctom/roundcubemail/blob/master/program/lib/Roundcube/rcube_storage.php): `program/lib/Roundcube/rcube_storage.php`
- [Address book](https://github.com/unctom/roundcubemail/tree/master/program/actions/contacts): `program/actions/contacts`
- [Settings actions](https://github.com/unctom/roundcubemail/tree/master/program/actions/settings): `program/actions/settings`

### Application framework

- [Runtime initialization](https://github.com/unctom/roundcubemail/blob/master/program/include/iniset.php): `program/include/iniset.php`
- [Framework bootstrap](https://github.com/unctom/roundcubemail/blob/master/program/lib/Roundcube/bootstrap.php): `program/lib/Roundcube/bootstrap.php`
- [Spell-check interface](https://github.com/unctom/roundcubemail/blob/master/program/lib/Roundcube/spellchecker/engine.php): `program/lib/Roundcube/spellchecker/engine.php`
- [Plugin API](https://github.com/unctom/roundcubemail/blob/master/program/lib/Roundcube/rcube_plugin_api.php): `program/lib/Roundcube/rcube_plugin_api.php`

### Extensions

- [Markdown editor](https://github.com/unctom/roundcubemail/blob/master/plugins/markdown_editor/javascript/index.js): `plugins/markdown_editor/javascript/index.js`
- [Editor toolbar button](https://github.com/unctom/roundcubemail/blob/master/plugins/markdown_editor/javascript/toolbar-button.js): `plugins/markdown_editor/javascript/toolbar-button.js`
- [Editor toolbar plugin](https://github.com/unctom/roundcubemail/blob/master/plugins/markdown_editor/javascript/toolbar-plugin.js): `plugins/markdown_editor/javascript/toolbar-plugin.js`
- [PGP mail support](https://github.com/unctom/roundcubemail/blob/master/plugins/enigma/lib/enigma_engine.php): `plugins/enigma/lib/enigma_engine.php`
- [Sieve filter editor](https://github.com/unctom/roundcubemail/blob/master/plugins/managesieve/lib/Roundcube/rcube_sieve_engine.php): `plugins/managesieve/lib/Roundcube/rcube_sieve_engine.php`

### Other components

- **Webmail user**
- **SQL database**
- **Sieve service**

## Connections

- Webmail user → Browser UI: uses
- Browser UI → HTTP front controller: sends requests
- HTTP front controller → Runtime initialization: initializes via (evidence: `public_html/index.php`)
- Runtime initialization → Framework bootstrap: loads (evidence: `program/include/iniset.php`)
- HTTP front controller → Mail actions: dispatches
- Mail actions → IMAP storage: uses for mail
- Webmail user → Address book: manages contacts
- Webmail user → Settings actions: manages settings
- Webmail user → Spell-check interface: checks spelling
- Mail actions → SQL database: uses
- Address book → SQL database: uses
- Settings actions → SQL database: uses
- HTTP front controller → Plugin API: runs plugin hooks
- Webmail user → Markdown editor: edits messages
- Markdown editor → Editor toolbar button: creates buttons (evidence: `plugins/markdown_editor/javascript/index.js`)
- Markdown editor → Editor toolbar plugin: imports (evidence: `plugins/markdown_editor/javascript/index.js`)
- Webmail user → PGP mail support: uses PGP features
- Webmail user → Sieve filter editor: manages filters
- Sieve filter editor → Sieve service: accesses
