# docusealco/docuseal architecture

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

- Interactive diagram: https://gitdiagram.com/docusealco/docuseal
- Repository: https://github.com/docusealco/docuseal

## Overview

DocuSeal is a web platform for creating fillable PDF forms and collecting electronic signatures. The main workflow is template creation, online completion by one or more submitters, and delivery of signed documents; the repository also exposes API/webhook integrations and account settings. The browser entry point and builder wiring are visible in the excerpts. Most Rails controllers and domain stages are represented from the tree and README capabilities; their internal calls were not sampled, so those links are documented workflow relationships rather than claims about specific controller calls.

Main entry points: [`app/javascript/template_builder/builder.vue`](https://github.com/docusealco/docuseal/blob/master/app/javascript/template_builder/builder.vue) (Template builder), [`app/controllers/submissions_controller.rb`](https://github.com/docusealco/docuseal/blob/master/app/controllers/submissions_controller.rb) (Submissions), [`app/javascript/application.js`](https://github.com/docusealco/docuseal/blob/master/app/javascript/application.js) (Web app entry), [`app/controllers/start_form_controller.rb`](https://github.com/docusealco/docuseal/blob/master/app/controllers/start_form_controller.rb) (Form access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Template authoring"]
  node_web_app["Web app entry<br/>[application.js]"]
  node_template_builder["Template builder<br/>[builder.vue]"]
  node_template_preview["Document preview<br/>[preview.vue]"]
  node_templates["Templates"]
  node_template_documents["Template documents"]
end

subgraph group_signing["Signing workflow"]
  node_form_start["Form access"]
  node_signing_ui["Signing interface<br/>[signature_form.js]"]
  node_form_submit["Form submission"]
  node_submissions["Submissions"]
end

subgraph group_operations["Documents and accounts"]
  node_signed_documents[("Signed documents")]
  node_accounts["Accounts and users"]
  node_storage["File storage"]
end

subgraph group_integrations["Integration surfaces"]
  node_api["Public API"]
  node_webhooks["Webhooks"]
  node_mcp["MCP tools"]
end

node_user(("User"))
node_submitter(("Submitter"))
node_browser(("Web browser"))

node_user -->|"uses"| node_browser
node_submitter -->|"opens form"| node_browser
node_browser -->|"loads"| node_web_app
node_web_app -->|"mounts"| node_template_builder
node_user -->|"creates forms"| node_template_builder
node_template_builder -->|"saves templates"| node_templates
node_template_builder -->|"previews documents"| node_template_preview
node_user -->|"uploads documents"| node_template_documents
node_submitter -->|"opens signing link"| node_form_start
node_form_start -->|"presents signing"| node_signing_ui
node_signing_ui -->|"submits fields"| node_form_submit
node_form_submit -->|"records response"| node_submissions
node_submissions -->|"produces signed PDFs"| node_signed_documents
node_user -->|"manages users"| node_accounts
node_user -->|"configures storage"| node_storage
node_user -->|"integrates via API"| node_api
node_submissions -->|"notifies integrations"| node_webhooks
node_user -.->|"uses MCP tools"| node_mcp

click node_web_app "https://github.com/docusealco/docuseal/blob/master/app/javascript/application.js"
click node_template_builder "https://github.com/docusealco/docuseal/blob/master/app/javascript/template_builder/builder.vue"
click node_template_preview "https://github.com/docusealco/docuseal/blob/master/app/javascript/template_builder/preview.vue"
click node_templates "https://github.com/docusealco/docuseal/blob/master/app/controllers/templates_controller.rb"
click node_template_documents "https://github.com/docusealco/docuseal/blob/master/app/controllers/template_documents_controller.rb"
click node_form_start "https://github.com/docusealco/docuseal/blob/master/app/controllers/start_form_controller.rb"
click node_signing_ui "https://github.com/docusealco/docuseal/blob/master/app/javascript/elements/signature_form.js"
click node_form_submit "https://github.com/docusealco/docuseal/blob/master/app/controllers/submit_form_controller.rb"
click node_submissions "https://github.com/docusealco/docuseal/blob/master/app/controllers/submissions_controller.rb"
click node_signed_documents "https://github.com/docusealco/docuseal/blob/master/app/models/completed_document.rb"
click node_accounts "https://github.com/docusealco/docuseal/blob/master/app/controllers/accounts_controller.rb"
click node_storage "https://github.com/docusealco/docuseal/blob/master/app/controllers/storage_settings_controller.rb"
click node_api "https://github.com/docusealco/docuseal/blob/master/app/controllers/api/submissions_controller.rb"
click node_webhooks "https://github.com/docusealco/docuseal/blob/master/app/jobs/send_form_completed_webhook_request_job.rb"
click node_mcp "https://github.com/docusealco/docuseal/blob/master/app/controllers/mcp/protocol_controller.rb"

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_web_app,node_template_builder,node_template_preview,node_templates,node_template_documents,node_user,node_browser toneBlue
class node_form_start,node_signing_ui,node_form_submit,node_submissions toneAmber
class node_signed_documents,node_accounts,node_storage toneMint
class node_api,node_webhooks,node_mcp toneRose
class node_submitter toneIndigo
```

## Components

### Template authoring

- [Web app entry](https://github.com/docusealco/docuseal/blob/master/app/javascript/application.js): `app/javascript/application.js`
- [Template builder](https://github.com/docusealco/docuseal/blob/master/app/javascript/template_builder/builder.vue): `app/javascript/template_builder/builder.vue`
- [Document preview](https://github.com/docusealco/docuseal/blob/master/app/javascript/template_builder/preview.vue): `app/javascript/template_builder/preview.vue`
- [Templates](https://github.com/docusealco/docuseal/blob/master/app/controllers/templates_controller.rb): `app/controllers/templates_controller.rb`
- [Template documents](https://github.com/docusealco/docuseal/blob/master/app/controllers/template_documents_controller.rb): `app/controllers/template_documents_controller.rb`

### Signing workflow

- [Form access](https://github.com/docusealco/docuseal/blob/master/app/controllers/start_form_controller.rb): `app/controllers/start_form_controller.rb`
- [Signing interface](https://github.com/docusealco/docuseal/blob/master/app/javascript/elements/signature_form.js): `app/javascript/elements/signature_form.js`
- [Form submission](https://github.com/docusealco/docuseal/blob/master/app/controllers/submit_form_controller.rb): `app/controllers/submit_form_controller.rb`
- [Submissions](https://github.com/docusealco/docuseal/blob/master/app/controllers/submissions_controller.rb): `app/controllers/submissions_controller.rb`

### Documents and accounts

- [Signed documents](https://github.com/docusealco/docuseal/blob/master/app/models/completed_document.rb): `app/models/completed_document.rb`
- [Accounts and users](https://github.com/docusealco/docuseal/blob/master/app/controllers/accounts_controller.rb): `app/controllers/accounts_controller.rb`
- [File storage](https://github.com/docusealco/docuseal/blob/master/app/controllers/storage_settings_controller.rb): `app/controllers/storage_settings_controller.rb`

### Integration surfaces

- [Public API](https://github.com/docusealco/docuseal/blob/master/app/controllers/api/submissions_controller.rb): `app/controllers/api/submissions_controller.rb`
- [Webhooks](https://github.com/docusealco/docuseal/blob/master/app/jobs/send_form_completed_webhook_request_job.rb): `app/jobs/send_form_completed_webhook_request_job.rb`
- [MCP tools](https://github.com/docusealco/docuseal/blob/master/app/controllers/mcp/protocol_controller.rb): `app/controllers/mcp/protocol_controller.rb`

### Other components

- **User**
- **Submitter**
- **Web browser**

## Connections

- User → Web browser: uses (evidence: `README.md`)
- Submitter → Web browser: opens form (evidence: `README.md`)
- Web browser → Web app entry: loads (evidence: `README.md`)
- Web app entry → Template builder: mounts (evidence: `app/javascript/application.js`)
- User → Template builder: creates forms (evidence: `README.md`)
- Template builder → Templates: saves templates (evidence: `README.md`)
- Template builder → Document preview: previews documents (evidence: `app/javascript/template_builder/preview.vue`)
- User → Template documents: uploads documents (evidence: `README.md`)
- Submitter → Form access: opens signing link (evidence: `README.md`)
- Form access → Signing interface: presents signing (evidence: `README.md`)
- Signing interface → Form submission: submits fields (evidence: `README.md`)
- Form submission → Submissions: records response (evidence: `README.md`)
- Submissions → Signed documents: produces signed PDFs (evidence: `README.md`)
- User → Accounts and users: manages users (evidence: `README.md`)
- User → File storage: configures storage (evidence: `README.md`)
- User → Public API: integrates via API (evidence: `README.md`)
- Submissions → Webhooks: notifies integrations (evidence: `README.md`)
- User → MCP tools: uses MCP tools
