# devjitpanja/wimailer architecture

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

- Interactive diagram: https://gitdiagram.com/devjitpanja/wimailer
- Repository: https://github.com/devjitpanja/wimailer

## Overview

WiMailer is a browser-based certificate personalisation and bulk-mailing tool. A user supplies a certificate image and spreadsheet, places and styles spreadsheet fields, optionally overrides them per recipient, then downloads certificates or composes personalised email and sends certificates through an SMTP proxy. The client logic is concentrated in one file, so its distinct responsibilities share that path. README capabilities supplement the partial client excerpt; links among those client stages are documented workflows, not separately verified calls.

Main entry points: [`js/app.js`](https://github.com/devjitpanja/wimailer/blob/main/js/app.js) (Certificate workspace), [`server.js`](https://github.com/devjitpanja/wimailer/blob/main/server.js) (SMTP API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Certificate workspace"]
  node_workspace["Certificate workspace<br/>[app.js]"]
  node_template["Template image<br/>[app.js]"]
  node_recipient_data["Recipient import<br/>[app.js]"]
  node_field_layout["Field layout<br/>[app.js]"]
  node_typography["Typography<br/>[app.js]"]
  node_row_overrides["Row overrides<br/>[app.js]"]
end

subgraph group_delivery["Email delivery"]
  node_email_composer["Email composer<br/>[app.js]"]
  node_saved_templates[("Saved templates<br/>[app.js]")]
  node_batch_send["Batch email sender<br/>[app.js]"]
  node_smtp_proxy["SMTP API<br/>[server.js]"]
end

subgraph group_outputs["Generated outputs"]
  node_certificate_rendering["Certificate rendering<br/>[app.js]"]
  node_download["PNG and ZIP export<br/>[app.js]"]
end

node_user(("User"))
node_smtp_service["SMTP server"]

node_user -->|"uses"| node_workspace
node_workspace -->|"loads image"| node_template
node_workspace -->|"imports spreadsheet"| node_recipient_data
node_workspace -->|"positions fields"| node_field_layout
node_workspace -->|"styles fields"| node_typography
node_workspace -->|"sets overrides"| node_row_overrides
node_workspace -->|"generates certificates"| node_certificate_rendering
node_workspace -->|"exports certificates"| node_download
node_workspace -->|"composes messages"| node_email_composer
node_email_composer -->|"saves templates"| node_saved_templates
node_workspace -->|"sends batch"| node_batch_send
node_batch_send -->|"posts email"| node_smtp_proxy
node_smtp_proxy -->|"sends via SMTP"| node_smtp_service

click node_workspace "https://github.com/devjitpanja/wimailer/blob/main/js/app.js"
click node_template "https://github.com/devjitpanja/wimailer/blob/main/js/app.js"
click node_recipient_data "https://github.com/devjitpanja/wimailer/blob/main/js/app.js"
click node_field_layout "https://github.com/devjitpanja/wimailer/blob/main/js/app.js"
click node_typography "https://github.com/devjitpanja/wimailer/blob/main/js/app.js"
click node_row_overrides "https://github.com/devjitpanja/wimailer/blob/main/js/app.js"
click node_certificate_rendering "https://github.com/devjitpanja/wimailer/blob/main/js/app.js"
click node_download "https://github.com/devjitpanja/wimailer/blob/main/js/app.js"
click node_email_composer "https://github.com/devjitpanja/wimailer/blob/main/js/app.js"
click node_saved_templates "https://github.com/devjitpanja/wimailer/blob/main/js/app.js"
click node_batch_send "https://github.com/devjitpanja/wimailer/blob/main/js/app.js"
click node_smtp_proxy "https://github.com/devjitpanja/wimailer/blob/main/server.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_workspace,node_template,node_recipient_data,node_field_layout,node_typography,node_row_overrides,node_user toneBlue
class node_email_composer,node_saved_templates,node_batch_send,node_smtp_proxy toneAmber
class node_certificate_rendering,node_download,node_smtp_service toneMint
```

## Components

### Certificate workspace

- [Certificate workspace](https://github.com/devjitpanja/wimailer/blob/main/js/app.js): `js/app.js`
- [Template image](https://github.com/devjitpanja/wimailer/blob/main/js/app.js): `js/app.js`
- [Recipient import](https://github.com/devjitpanja/wimailer/blob/main/js/app.js): `js/app.js`
- [Field layout](https://github.com/devjitpanja/wimailer/blob/main/js/app.js): `js/app.js`
- [Typography](https://github.com/devjitpanja/wimailer/blob/main/js/app.js): `js/app.js`
- [Row overrides](https://github.com/devjitpanja/wimailer/blob/main/js/app.js): `js/app.js`

### Email delivery

- [Email composer](https://github.com/devjitpanja/wimailer/blob/main/js/app.js): `js/app.js`
- [Saved templates](https://github.com/devjitpanja/wimailer/blob/main/js/app.js): `js/app.js`
- [Batch email sender](https://github.com/devjitpanja/wimailer/blob/main/js/app.js): `js/app.js`
- [SMTP API](https://github.com/devjitpanja/wimailer/blob/main/server.js): `server.js`

### Generated outputs

- [Certificate rendering](https://github.com/devjitpanja/wimailer/blob/main/js/app.js): `js/app.js`
- [PNG and ZIP export](https://github.com/devjitpanja/wimailer/blob/main/js/app.js): `js/app.js`

### Other components

- **User**
- **SMTP server**

## Connections

- User → Certificate workspace: uses (evidence: `README.md`)
- Certificate workspace → Template image: loads image (evidence: `README.md`)
- Certificate workspace → Recipient import: imports spreadsheet (evidence: `README.md`)
- Certificate workspace → Field layout: positions fields (evidence: `README.md`)
- Certificate workspace → Typography: styles fields (evidence: `README.md`)
- Certificate workspace → Row overrides: sets overrides (evidence: `README.md`)
- Certificate workspace → Certificate rendering: generates certificates (evidence: `README.md`)
- Certificate workspace → PNG and ZIP export: exports certificates (evidence: `README.md`)
- Certificate workspace → Email composer: composes messages (evidence: `README.md`)
- Email composer → Saved templates: saves templates (evidence: `README.md`)
- Certificate workspace → Batch email sender: sends batch (evidence: `README.md`)
- Batch email sender → SMTP API: posts email (evidence: `README.md`)
- SMTP API → SMTP server: sends via SMTP (evidence: `server.js`)
