# m66b/fairemail architecture

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

- Interactive diagram: https://gitdiagram.com/m66b/fairemail
- Repository: https://github.com/m66b/fairemail

## Overview

FairEmail is an Android email client: people configure accounts, synchronize and read messages, then compose and send replies through standard mail protocols. The README also describes offline use, push, search, filtering, privacy protections, encryption and convenience features. The excerpts show EmailService configuring mail protocols and JavaMail’s session/provider model, but do not show the app’s activity-to-service routing or most feature implementations; those relationships are therefore documented only where the README supports them.

Main entry points: [`app/src/main/java/eu/faircode/email/EmailService.java`](https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/EmailService.java) (Email service), [`app/src/main/java/eu/faircode/email/ActivityMain.java`](https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivityMain.java) (Mailbox UI), [`app/src/main/java/eu/faircode/email/ActivityView.java`](https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivityView.java) (Message view), [`app/src/main/java/com/sun/mail/imap/IMAPStore.java`](https://github.com/m66b/fairemail/blob/master/app/src/main/java/com/sun/mail/imap/IMAPStore.java) (IMAP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_main["Mailbox UI<br/>[ActivityMain.java]"]
  node_view["Message view<br/>[ActivityView.java]"]
  node_compose["Compose message"]
  node_setup["Account setup<br/>[ActivitySetup.java]"]
end

subgraph group_sync["Mail synchronization"]
  node_emailservice["Email service<br/>[EmailService.java]"]
  node_offline["Offline operations"]
  node_idle["IMAP IDLE<br/>[IdleManager.java]"]
end

subgraph group_mail["Mail protocols"]
  node_session["Mail session<br/>[Session.java]"]
  node_service["Mail service API<br/>[Service.java]"]
  node_store["Mail store API<br/>[Store.java]"]
  node_folder["Mail folders<br/>[Folder.java]"]
  node_message["Mail messages<br/>[Message.java]"]
  node_imap["IMAP client<br/>[IMAPStore.java]"]
  node_imapfolder["IMAP folders<br/>[IMAPFolder.java]"]
  node_imapprotocol["IMAP protocol<br/>[IMAPProtocol.java]"]
  node_smtp["SMTP transport<br/>[SMTPTransport.java]"]
end

subgraph group_features["Mail features"]
  node_search["Search and indexing"]
  node_rules["Filter rules<br/>[AdapterRule.java]"]
  node_privacy["Safe message display<br/>[ActivityView.java]"]
  node_openpgp["OpenPGP support<br/>[OpenPgpApi.java]"]
  node_smime["S/MIME support"]
  node_notifications["Push notifications"]
  node_widget["Message list widget"]
end

node_person(("Email user"))
node_provider(("Email provider"))

node_person -->|"configures account"| node_setup
node_person -->|"reads mail"| node_main
node_person -->|"writes mail"| node_compose
node_setup -.->|"configures mail"| node_emailservice
node_emailservice -.->|"configures session"| node_session
node_session -->|"selects providers"| node_service
node_service -.->|"provides store"| node_store
node_emailservice -->|"uses IMAP"| node_imap
node_emailservice -->|"uses SMTP"| node_smtp
node_imap -->|"opens folders"| node_imapfolder
node_imapfolder -->|"issues commands"| node_imapprotocol
node_imap -->|"synchronizes mail"| node_provider
node_smtp -->|"sends mail"| node_provider
node_emailservice -.->|"supports push"| node_idle
node_main -.->|"opens messages"| node_view
node_view -->|"displays safely"| node_privacy
node_compose -.->|"sends message"| node_smtp
node_emailservice -->|"supports offline use"| node_offline
node_main -->|"supports search"| node_search
node_emailservice -->|"supports filtering"| node_rules
node_view -.->|"decrypts messages"| node_openpgp
node_view -->|"supports encryption"| node_smime
node_main -->|"receives alerts"| node_notifications
node_main -->|"offers widget"| node_widget

click node_main "https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivityMain.java"
click node_view "https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivityView.java"
click node_compose "https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivityCompose.java"
click node_setup "https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivitySetup.java"
click node_emailservice "https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/EmailService.java"
click node_offline "https://github.com/m66b/fairemail/tree/master/app/src/main/java/eu/faircode/email"
click node_idle "https://github.com/m66b/fairemail/blob/master/app/src/main/java/com/sun/mail/imap/IdleManager.java"
click node_session "https://github.com/m66b/fairemail/blob/master/app/src/main/java/javax/mail/Session.java"
click node_service "https://github.com/m66b/fairemail/blob/master/app/src/main/java/javax/mail/Service.java"
click node_store "https://github.com/m66b/fairemail/blob/master/app/src/main/java/javax/mail/Store.java"
click node_folder "https://github.com/m66b/fairemail/blob/master/app/src/main/java/javax/mail/Folder.java"
click node_message "https://github.com/m66b/fairemail/blob/master/app/src/main/java/javax/mail/Message.java"
click node_imap "https://github.com/m66b/fairemail/blob/master/app/src/main/java/com/sun/mail/imap/IMAPStore.java"
click node_imapfolder "https://github.com/m66b/fairemail/blob/master/app/src/main/java/com/sun/mail/imap/IMAPFolder.java"
click node_imapprotocol "https://github.com/m66b/fairemail/blob/master/app/src/main/java/com/sun/mail/imap/protocol/IMAPProtocol.java"
click node_smtp "https://github.com/m66b/fairemail/blob/master/app/src/main/java/com/sun/mail/smtp/SMTPTransport.java"
click node_search "https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivitySearch.java"
click node_rules "https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/AdapterRule.java"
click node_privacy "https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivityView.java"
click node_openpgp "https://github.com/m66b/fairemail/blob/master/openpgp-api/src/main/java/org/openintents/openpgp/util/OpenPgpApi.java"
click node_smime "https://github.com/m66b/fairemail/tree/master/app/src/main/java/eu/faircode/email"
click node_notifications "https://github.com/m66b/fairemail/tree/master/app/src/main/java/eu/faircode/email"
click node_widget "https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivityWidget.java"

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_main,node_view,node_compose,node_setup,node_person toneBlue
class node_emailservice,node_offline,node_idle toneAmber
class node_session,node_service,node_store,node_folder,node_message,node_imap,node_imapfolder,node_imapprotocol,node_smtp toneMint
class node_search,node_rules,node_privacy,node_openpgp,node_smime,node_notifications,node_widget toneRose
class node_provider toneIndigo
```

## Components

### App experience

- [Mailbox UI](https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivityMain.java): `app/src/main/java/eu/faircode/email/ActivityMain.java`
- [Message view](https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivityView.java): `app/src/main/java/eu/faircode/email/ActivityView.java`
- [Compose message](https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivityCompose.java): `app/src/main/java/eu/faircode/email/ActivityCompose.java`
- [Account setup](https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivitySetup.java): `app/src/main/java/eu/faircode/email/ActivitySetup.java`

### Mail synchronization

- [Email service](https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/EmailService.java): `app/src/main/java/eu/faircode/email/EmailService.java`
- [Offline operations](https://github.com/m66b/fairemail/tree/master/app/src/main/java/eu/faircode/email): `app/src/main/java/eu/faircode/email`
- [IMAP IDLE](https://github.com/m66b/fairemail/blob/master/app/src/main/java/com/sun/mail/imap/IdleManager.java): `app/src/main/java/com/sun/mail/imap/IdleManager.java`

### Mail protocols

- [Mail session](https://github.com/m66b/fairemail/blob/master/app/src/main/java/javax/mail/Session.java): `app/src/main/java/javax/mail/Session.java`
- [Mail service API](https://github.com/m66b/fairemail/blob/master/app/src/main/java/javax/mail/Service.java): `app/src/main/java/javax/mail/Service.java`
- [Mail store API](https://github.com/m66b/fairemail/blob/master/app/src/main/java/javax/mail/Store.java): `app/src/main/java/javax/mail/Store.java`
- [Mail folders](https://github.com/m66b/fairemail/blob/master/app/src/main/java/javax/mail/Folder.java): `app/src/main/java/javax/mail/Folder.java`
- [Mail messages](https://github.com/m66b/fairemail/blob/master/app/src/main/java/javax/mail/Message.java): `app/src/main/java/javax/mail/Message.java`
- [IMAP client](https://github.com/m66b/fairemail/blob/master/app/src/main/java/com/sun/mail/imap/IMAPStore.java): `app/src/main/java/com/sun/mail/imap/IMAPStore.java`
- [IMAP folders](https://github.com/m66b/fairemail/blob/master/app/src/main/java/com/sun/mail/imap/IMAPFolder.java): `app/src/main/java/com/sun/mail/imap/IMAPFolder.java`
- [IMAP protocol](https://github.com/m66b/fairemail/blob/master/app/src/main/java/com/sun/mail/imap/protocol/IMAPProtocol.java): `app/src/main/java/com/sun/mail/imap/protocol/IMAPProtocol.java`
- [SMTP transport](https://github.com/m66b/fairemail/blob/master/app/src/main/java/com/sun/mail/smtp/SMTPTransport.java): `app/src/main/java/com/sun/mail/smtp/SMTPTransport.java`

### Mail features

- [Search and indexing](https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivitySearch.java): `app/src/main/java/eu/faircode/email/ActivitySearch.java`
- [Filter rules](https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/AdapterRule.java): `app/src/main/java/eu/faircode/email/AdapterRule.java`
- [Safe message display](https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivityView.java): `app/src/main/java/eu/faircode/email/ActivityView.java`
- [OpenPGP support](https://github.com/m66b/fairemail/blob/master/openpgp-api/src/main/java/org/openintents/openpgp/util/OpenPgpApi.java): `openpgp-api/src/main/java/org/openintents/openpgp/util/OpenPgpApi.java`
- [S/MIME support](https://github.com/m66b/fairemail/tree/master/app/src/main/java/eu/faircode/email): `app/src/main/java/eu/faircode/email`
- [Push notifications](https://github.com/m66b/fairemail/tree/master/app/src/main/java/eu/faircode/email): `app/src/main/java/eu/faircode/email`
- [Message list widget](https://github.com/m66b/fairemail/blob/master/app/src/main/java/eu/faircode/email/ActivityWidget.java): `app/src/main/java/eu/faircode/email/ActivityWidget.java`

### Other components

- **Email user**
- **Email provider**

## Connections

- Email user → Account setup: configures account
- Email user → Mailbox UI: reads mail
- Email user → Compose message: writes mail
- Account setup → Email service: configures mail
- Email service → Mail session: configures session (evidence: `app/src/main/java/eu/faircode/email/EmailService.java`)
- Mail session → Mail service API: selects providers (evidence: `app/src/main/java/javax/mail/Session.java`)
- Mail service API → Mail store API: provides store
- Email service → IMAP client: uses IMAP (evidence: `app/src/main/java/eu/faircode/email/EmailService.java`)
- Email service → SMTP transport: uses SMTP (evidence: `app/src/main/java/eu/faircode/email/EmailService.java`)
- IMAP client → IMAP folders: opens folders (evidence: `app/src/main/java/com/sun/mail/imap/IMAPFolder.java`)
- IMAP folders → IMAP protocol: issues commands (evidence: `app/src/main/java/com/sun/mail/imap/IMAPFolder.java`)
- IMAP client → Email provider: synchronizes mail
- SMTP transport → Email provider: sends mail
- Email service → IMAP IDLE: supports push
- Mailbox UI → Message view: opens messages
- Message view → Safe message display: displays safely
- Compose message → SMTP transport: sends message
- Email service → Offline operations: supports offline use (evidence: `app/src/main/java/eu/faircode/email/EmailService.java`)
- Mailbox UI → Search and indexing: supports search
- Email service → Filter rules: supports filtering
- Message view → OpenPGP support: decrypts messages
- Message view → S/MIME support: supports encryption
- Mailbox UI → Push notifications: receives alerts
- Mailbox UI → Message list widget: offers widget
