From ddb3422852caf0fd833a26e10dab4f7443d54438 Mon Sep 17 00:00:00 2001
From: Linus Rath <139418639+rathlinus@users.noreply.github.com>
Date: Mon, 23 Mar 2026 23:07:19 +0100
Subject: [PATCH] feat: add default mail program settings with localization
 support

---
 components/settings/email-settings.tsx | 37 ++++++++++++++++++++++++--
 locales/de/common.json                 |  7 +++++
 locales/en/common.json                 |  7 +++++
 locales/es/common.json                 |  7 +++++
 locales/fr/common.json                 |  7 +++++
 locales/it/common.json                 |  7 +++++
 locales/ja/common.json                 |  7 +++++
 locales/nl/common.json                 |  7 +++++
 locales/pt/common.json                 |  7 +++++
 9 files changed, 91 insertions(+), 2 deletions(-)

diff --git a/components/settings/email-settings.tsx b/components/settings/email-settings.tsx
index 6bd31dea..132565f4 100644
--- a/components/settings/email-settings.tsx
+++ b/components/settings/email-settings.tsx
@@ -1,7 +1,8 @@
 "use client";
 
-import { useState } from 'react';
+import { useState, useCallback } from 'react';
 import { useTranslations } from 'next-intl';
+import { useConfig } from '@/hooks/use-config';
 import { useSettingsStore } from '@/stores/settings-store';
 import type { ArchiveMode, HoverAction } from '@/stores/settings-store';
 import { ALL_HOVER_ACTIONS } from '@/stores/settings-store';
@@ -10,13 +11,26 @@ import { useEmailStore } from '@/stores/email-store';
 import { cn } from '@/lib/utils';
 import { SettingsSection, SettingItem, Select, ToggleSwitch } from './settings-section';
 import { TrustedSendersModal } from '@/components/trusted-senders-modal';
-import { ChevronRight, AlertTriangle, FolderSync, Loader2 } from 'lucide-react';
+import { ChevronRight, AlertTriangle, FolderSync, Loader2, Mail } from 'lucide-react';
 
 export function EmailSettings() {
   const t = useTranslations('settings.email_behavior');
+  const { appName } = useConfig();
   const [showTrustedModal, setShowTrustedModal] = useState(false);
   const [isReorganizing, setIsReorganizing] = useState(false);
   const [reorganizeResult, setReorganizeResult] = useState<string | null>(null);
+  const [defaultMailStatus, setDefaultMailStatus] = useState<'idle' | 'success' | 'error'>('idle');
+
+  const handleSetDefaultMailProgram = useCallback(() => {
+    try {
+      if (typeof navigator !== 'undefined' && navigator.registerProtocolHandler) {
+        navigator.registerProtocolHandler('mailto', `${window.location.origin}/compose?mailto=%s`);
+        setDefaultMailStatus('success');
+      }
+    } catch {
+      setDefaultMailStatus('error');
+    }
+  }, []);
 
   const {
     markAsReadDelay,
@@ -279,6 +293,25 @@ export function EmailSettings() {
         />
       </SettingItem>
 
+      {/* Default Mail Program */}
+      <SettingItem label={t('default_mail_program.label')} description={t('default_mail_program.description', { appName: appName || 'Bulwark' })}>
+        <div className="flex flex-col items-end gap-1">
+          <button
+            onClick={handleSetDefaultMailProgram}
+            className="flex items-center gap-2 px-3 py-1.5 bg-muted hover:bg-accent rounded-md transition-colors"
+          >
+            <Mail className="w-4 h-4" />
+            <span className="text-sm text-foreground">{t('default_mail_program.button')}</span>
+          </button>
+          {defaultMailStatus === 'success' && (
+            <p className="text-xs text-green-600 dark:text-green-400">{t('default_mail_program.success')}</p>
+          )}
+          {defaultMailStatus === 'error' && (
+            <p className="text-xs text-destructive">{t('default_mail_program.error')}</p>
+          )}
+        </div>
+      </SettingItem>
+
       {/* Trusted Senders */}
       <SettingItem label={t('trusted_senders.label')} description={t('trusted_senders.description')}>
         <button
diff --git a/locales/de/common.json b/locales/de/common.json
index fd6d18ff..17cb3f22 100644
--- a/locales/de/common.json
+++ b/locales/de/common.json
@@ -855,6 +855,13 @@
         "tag": "Schlagwort",
         "spam": "Als Spam markieren",
         "none_selected": "Keine Aktionen ausgewählt"
+      },
+      "default_mail_program": {
+        "label": "Standard-E-Mail-Programm",
+        "description": "Registrieren Sie {appName} als Ihr Standard-E-Mail-Programm für mailto:-Links",
+        "button": "Als Standard festlegen",
+        "success": "Browser wurde aufgefordert, als Standard festzulegen",
+        "error": "Ihr Browser unterstützt diese Funktion nicht"
       }
     },
     "composer": {
diff --git a/locales/en/common.json b/locales/en/common.json
index 6cf6111a..5f6b9e79 100644
--- a/locales/en/common.json
+++ b/locales/en/common.json
@@ -855,6 +855,13 @@
         "tag": "Tag",
         "spam": "Mark as Spam",
         "none_selected": "No actions selected"
+      },
+      "default_mail_program": {
+        "label": "Default Mail Program",
+        "description": "Register {appName} as your default mail program for mailto: links",
+        "button": "Set as Default",
+        "success": "Browser prompted to set as default",
+        "error": "Your browser does not support this feature"
       }
     },
     "composer": {
diff --git a/locales/es/common.json b/locales/es/common.json
index 7e48d246..be56888b 100644
--- a/locales/es/common.json
+++ b/locales/es/common.json
@@ -855,6 +855,13 @@
         "tag": "Etiqueta",
         "spam": "Marcar como spam",
         "none_selected": "No hay acciones seleccionadas"
+      },
+      "default_mail_program": {
+        "label": "Programa de correo predeterminado",
+        "description": "Registrar {appName} como su programa de correo predeterminado para enlaces mailto:",
+        "button": "Establecer como predeterminado",
+        "success": "El navegador solicitó establecer como predeterminado",
+        "error": "Su navegador no admite esta función"
       }
     },
     "composer": {
diff --git a/locales/fr/common.json b/locales/fr/common.json
index ed742b0f..d8b2c506 100644
--- a/locales/fr/common.json
+++ b/locales/fr/common.json
@@ -855,6 +855,13 @@
         "tag": "Étiquette",
         "spam": "Marquer comme spam",
         "none_selected": "Aucune action sélectionnée"
+      },
+      "default_mail_program": {
+        "label": "Programme de messagerie par défaut",
+        "description": "Enregistrer {appName} comme programme de messagerie par défaut pour les liens mailto:",
+        "button": "Définir par défaut",
+        "success": "Le navigateur a été invité à définir par défaut",
+        "error": "Votre navigateur ne prend pas en charge cette fonctionnalité"
       }
     },
     "composer": {
diff --git a/locales/it/common.json b/locales/it/common.json
index 65e6dd79..580e69df 100644
--- a/locales/it/common.json
+++ b/locales/it/common.json
@@ -855,6 +855,13 @@
         "tag": "Etichetta",
         "spam": "Segna come spam",
         "none_selected": "Nessuna azione selezionata"
+      },
+      "default_mail_program": {
+        "label": "Programma di posta predefinito",
+        "description": "Registra {appName} come programma di posta predefinito per i link mailto:",
+        "button": "Imposta come predefinito",
+        "success": "Il browser ha chiesto di impostare come predefinito",
+        "error": "Il tuo browser non supporta questa funzionalità"
       }
     },
     "composer": {
diff --git a/locales/ja/common.json b/locales/ja/common.json
index c341921f..4b7c6a8c 100644
--- a/locales/ja/common.json
+++ b/locales/ja/common.json
@@ -855,6 +855,13 @@
         "tag": "タグ",
         "spam": "スパムとしてマーク",
         "none_selected": "アクションが選択されていません"
+      },
+      "default_mail_program": {
+        "label": "既定のメールプログラム",
+        "description": "{appName}をmailto:リンクの既定のメールプログラムとして登録します",
+        "button": "既定に設定",
+        "success": "ブラウザに既定として設定するよう要求しました",
+        "error": "お使いのブラウザはこの機能をサポートしていません"
       }
     },
     "composer": {
diff --git a/locales/nl/common.json b/locales/nl/common.json
index 214d46e9..0820189b 100644
--- a/locales/nl/common.json
+++ b/locales/nl/common.json
@@ -855,6 +855,13 @@
         "tag": "Label",
         "spam": "Markeer als spam",
         "none_selected": "Geen acties geselecteerd"
+      },
+      "default_mail_program": {
+        "label": "Standaard e-mailprogramma",
+        "description": "Registreer {appName} als uw standaard e-mailprogramma voor mailto:-links",
+        "button": "Instellen als standaard",
+        "success": "Browser gevraagd om als standaard in te stellen",
+        "error": "Uw browser ondersteunt deze functie niet"
       }
     },
     "composer": {
diff --git a/locales/pt/common.json b/locales/pt/common.json
index 79c79748..9e45864c 100644
--- a/locales/pt/common.json
+++ b/locales/pt/common.json
@@ -855,6 +855,13 @@
         "tag": "Etiqueta",
         "spam": "Marcar como spam",
         "none_selected": "Nenhuma ação selecionada"
+      },
+      "default_mail_program": {
+        "label": "Programa de e-mail padrão",
+        "description": "Registrar {appName} como seu programa de e-mail padrão para links mailto:",
+        "button": "Definir como padrão",
+        "success": "O navegador solicitou definir como padrão",
+        "error": "Seu navegador não suporta esta funcionalidade"
       }
     },
     "composer": {