Self-hosted email delivery platform that enables applications to send emails via HTTP APIs while handling SMTP delivery, templates, storage, security, and analytics. Fully self-hostable alternative to services like SendGrid or Mailgun.
Go email-relayemail-routinghttp-to-smtpmail-deliverymailchimp-alternativemailgun-alternativemailsendermailservermailtemplatemailtestpostmark-alternativesend-emailsendgrid-alternativesendmailtransactional-emailtransactional-outbox
<script setup lang="ts">
import { ref, computed, onMounted, watch, nextTick } from 'vue'
import { settingsApi } from '../../api/settings'
import { authApi } from '../../api/auth'
import { useThemeStore, type ThemeMode } from '../../stores/theme'
import { useNotificationStore } from '../../stores/notification'
import { useWorkspaceStore } from '../../stores/workspace'
import { apiMessage } from '../../composables/apiError'
import type { UserSettings } from '../../api/types'
const theme = useThemeStore()
const notify = useNotificationStore()
const wsStore = useWorkspaceStore()
const loading = ref(true)
// The default workspace is saved through its own endpoint, not the debounced
// settings form above, so it is kept out of `form` deliberately.
// Two refs on purpose. `savedWorkspaceId` is the server's answer; `selected` is
// what the control shows. Reverting a failed save has to move `selected`, which
// the user already changed — writing the old value back to a ref that never
// changed would not re-render, and the select would keep showing a choice that
// was never saved.
const savedWorkspaceId = ref<number | null>(null)
const selectedWorkspaceId = ref<number | null>(null)
const savingDefaultWorkspace = ref(false)
const workspaceChoices = computed(() => wsStore.ownWorkspaces)
async function loadDefaultWorkspace() {
try {
const res = await authApi.me()
savedWorkspaceId.value = res.data.data.default_workspace_id ?? null
selectedWorkspaceId.value = savedWorkspaceId.value
} catch {
// Non-critical: the select falls back to "not set".
}
}
async function saveDefaultWorkspace() {
const next = selectedWorkspaceId.value
if (!next || next === savedWorkspaceId.value) return
savingDefaultWorkspace.value = true
try {
await authApi.setDefaultWorkspace(next)
savedWorkspaceId.value = next
notify.success('Default workspace updated')
} catch (e: any) {
selectedWorkspaceId.value = savedWorkspaceId.value
notify.error(apiMessage(e, 'Failed to update the default workspace'))
} finally {
savingDefaultWorkspace.value = false
}
}
// Auto-save state. saveStatus drives the header indicator; ready gates the
// watcher so the initial load doesn't trigger a save.
type SaveStatus = 'idle' | 'unsaved' | 'saving' | 'saved' | 'error'
const saveStatus = ref<SaveStatus>('idle')
const ready = ref(false)
const dirty = ref(false)
const saving = ref(false)
const AUTOSAVE_DEBOUNCE_MS = 800
const SAVED_INDICATOR_MS = 2000
let debounceTimer: ReturnType<typeof setTimeout> | null = null
let savedClearTimer: ReturnType<typeof setTimeout> | null = null
// User settings are personal notification preferences only. Operational settings
// (sending defaults, webhooks, API-key expiry, domain security, data) live on the
// workspace — see Workspace Settings (workspace-only migration §2c/§5).
const form = ref<Partial<UserSettings>>({
email_notifications: true,
notification_email: '',
daily_report: true,
notify_bounce_alerts: true,
notify_api_key_expiry: true,
notify_workspace_activity: true,
notify_new_message: true,
})
// Per-type notification toggles rendered under the master switch. Security
// alerts (sign-in, 2FA, password, account deletion) are always on and shown
// separately as informational.
const notificationTypes: {
key: 'daily_report' | 'notify_bounce_alerts' | 'notify_api_key_expiry' | 'notify_workspace_activity' | 'notify_new_message'
label: string
hint: string
}[] = [
{ key: 'notify_bounce_alerts', label: 'Bounce & deliverability alerts', hint: 'Warn me when my bounce rate crosses the safe threshold.' },
{ key: 'notify_api_key_expiry', label: 'API key expiry reminders', hint: 'Remind me before an API key expires.' },
{ key: 'notify_workspace_activity', label: 'Workspace updates', hint: 'Notify me about role changes and workspace activity.' },
{ key: 'notify_new_message', label: 'Web form messages', hint: 'Notify me when a website form receives a new message.' },
{ key: 'daily_report', label: 'Daily report', hint: 'Receive a daily email summary of send statistics.' },
]
function toggleType(key: typeof notificationTypes[number]['key']) {
form.value[key] = !form.value[key]
}
// Theme
const themeModes: { value: ThemeMode; label: string; icon: string }[] = [
{ value: 'light', label: 'Light', icon: 'sun' },
{ value: 'dark', label: 'Dark', icon: 'moon' },
{ value: 'system', label: 'System', icon: 'monitor' },
]
onMounted(async () => {
loadDefaultWorkspace()
if (!wsStore.workspaces.length) wsStore.fetchWorkspaces()
try {
const res = await settingsApi.getUserSettings()
const u = res.data.data
form.value = {
email_notifications: u.email_notifications,
notification_email: u.notification_email || '',
daily_report: u.daily_report,
notify_bounce_alerts: u.notify_bounce_alerts,
notify_api_key_expiry: u.notify_api_key_expiry,
notify_workspace_activity: u.notify_workspace_activity,
notify_new_message: u.notify_new_message,
}
} catch {
notify.error('Failed to load settings')
} finally {
loading.value = false
// Wait one tick so the watcher doesn't fire on the load-time assignment.
await nextTick()
ready.value = true
}
})
watch(
form,
() => {
if (!ready.value) return
dirty.value = true
saveStatus.value = 'unsaved'
if (debounceTimer) clearTimeout(debounceTimer)
debounceTimer = setTimeout(autoSave, AUTOSAVE_DEBOUNCE_MS)
},
{ deep: true },
)
async function autoSave() {
if (saving.value) return
if (!dirty.value) return
saving.value = true
saveStatus.value = 'saving'
dirty.value = false
if (savedClearTimer) {
clearTimeout(savedClearTimer)
savedClearTimer = null
}
try {
await settingsApi.updateUserSettings(form.value)
saveStatus.value = 'saved'
savedClearTimer = setTimeout(() => {
if (saveStatus.value === 'saved') saveStatus.value = 'idle'
}, SAVED_INDICATOR_MS)
} catch {
saveStatus.value = 'error'
dirty.value = true
notify.error('Failed to save settings')
} finally {
saving.value = false
if (dirty.value) {
if (debounceTimer) clearTimeout(debounceTimer)
debounceTimer = setTimeout(autoSave, AUTOSAVE_DEBOUNCE_MS)
}
}
}
</script>
<template>
<div>
<div class="page-header">
<h1>Settings</h1>
<span
v-if="saveStatus !== 'idle'"
class="save-status"
:class="saveStatus"
role="status"
aria-live="polite"
>
<span class="save-status-dot" aria-hidden="true"></span>
<template v-if="saveStatus === 'saving'">Saving…</template>
<template v-else-if="saveStatus === 'saved'">Saved</template>
<template v-else-if="saveStatus === 'unsaved'">Unsaved changes</template>
<template v-else-if="saveStatus === 'error'">Save failed</template>
</span>
</div>
<div v-if="loading" class="loading-page">
<div class="spinner"></div>
</div>
<div v-else class="settings-grid">
<!-- Notifications -->
<div class="card">
<div class="card-header"><h2>Notifications</h2></div>
<div class="card-body">
<div class="toggle-row">
<div>
<label class="toggle-label">Email Notifications</label>
<span class="form-hint">Master switch for all notification emails below. Turn off to pause everything except security alerts.</span>
</div>
<button
:class="['toggle-btn', { active: form.email_notifications }]"
@click="form.email_notifications = !form.email_notifications"
>
<span class="toggle-slider"></span>
</button>
</div>
<div class="form-group" style="margin-top: 16px">
<label class="form-label">Notification Email</label>
<input v-model="form.notification_email" type="email" class="form-input" placeholder="Defaults to your login email" />
<span class="form-hint">Where to send notifications (can differ from your login email).</span>
</div>
<div class="notif-divider"></div>
<p class="notif-group-title">Notification types</p>
<p class="form-hint" style="margin-top: -4px; margin-bottom: 8px">You receive all of these by default. Turn off any you don't want.</p>
<div
v-for="t in notificationTypes"
:key="t.key"
class="toggle-row notif-type-row"
:class="{ 'notif-disabled': !form.email_notifications }"
>
<div>
<label class="toggle-label">{{ t.label }}</label>
<span class="form-hint">{{ t.hint }}</span>
</div>
<button
:class="['toggle-btn', { active: form.email_notifications && form[t.key] }]"
:disabled="!form.email_notifications"
@click="toggleType(t.key)"
>
<span class="toggle-slider"></span>
</button>
</div>
<div class="notif-divider"></div>
<div class="toggle-row notif-type-row">
<div>
<label class="toggle-label">Security alerts</label>
<span class="form-hint">Sign-ins from new devices, 2FA changes, password changes, and account deletion. Always on to protect your account.</span>
</div>
<span class="badge badge-success notif-always-on">Always on</span>
</div>
</div>
</div>
<!-- Default workspace -->
<div class="card">
<div class="card-header"><h2>Default workspace</h2></div>
<div class="card-body">
<p class="section-description">
Where a request that names no workspace operates. The dashboard always names one,
so this applies to API keys, the SDKs, and curl — anything that omits the
<code>X-Posta-Workspace-Id</code> header.
</p>
<div v-if="!workspaceChoices.length" class="form-hint">
You do not belong to a workspace yet.
</div>
<div v-else class="form-group">
<label class="form-label" for="default-workspace">Workspace</label>
<select
id="default-workspace"
v-model.number="selectedWorkspaceId"
class="form-select"
:disabled="savingDefaultWorkspace"
@change="saveDefaultWorkspace"
>
<option v-if="savedWorkspaceId === null" :value="null" disabled>Not set</option>
<option v-for="ws in workspaceChoices" :key="ws.id" :value="ws.id">
{{ ws.display_name }}
</option>
</select>
<span class="form-hint">
Your role in the chosen workspace applies to those requests, so a viewer stays a viewer.
</span>
</div>
</div>
</div>
<!-- Theme -->
<div class="card">
<div class="card-header"><h2>Theme</h2></div>
<div class="card-body">
<p class="section-description">Choose how the application looks to you.</p>
<div class="theme-options">
<button
v-for="m in themeModes"
:key="m.value"
:class="['theme-option', { active: theme.mode === m.value }]"
@click="theme.setMode(m.value)"
>
<div class="theme-option-icon">
<svg v-if="m.icon === 'sun'" width="20" height="20" viewBox="0 0 16 16" fill="none"><circle cx="8" cy="8" r="3" stroke="currentColor" stroke-width="1.5"/><path d="M8 1v2M8 13v2M1 8h2M13 8h2M3.05 3.05l1.41 1.41M11.54 11.54l1.41 1.41M3.05 12.95l1.41-1.41M11.54 4.46l1.41-1.41" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"/></svg>
<svg v-else-if="m.icon === 'moon'" width="20" height="20" viewBox="0 0 16 16" fill="none"><path d="M14 9.5A6.5 6.5 0 016.5 2 6.5 6.5 0 1014 9.5z" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/></svg>
<svg v-else width="20" height="20" viewBox="0 0 16 16" fill="none"><rect x="2" y="3" width="12" height="10" rx="1.5" stroke="currentColor" stroke-width="1.5"/><path d="M2 5.5h12" stroke="currentColor" stroke-width="1.5"/></svg>
</div>
<span class="theme-option-label">{{ m.label }}</span>
</button>
</div>
</div>
</div>
</div>
</div>
</template>
<style scoped>
.settings-grid {
display: grid;
gap: 24px;
max-width: 640px;
}
.form-hint {
font-size: 12px;
color: var(--text-muted);
margin-top: 4px;
display: block;
}
.section-description {
font-size: 13px;
color: var(--text-secondary);
margin-bottom: 16px;
}
.toggle-row {
display: flex;
align-items: center;
justify-content: space-between;
gap: 12px;
}
.toggle-label {
font-size: 14px;
font-weight: 500;
color: var(--text-primary);
}
.toggle-btn {
position: relative;
width: 44px;
height: 24px;
border-radius: 12px;
border: none;
background: var(--border-primary);
cursor: pointer;
transition: background 0.2s;
padding: 0;
flex-shrink: 0;
}
.toggle-btn.active {
background: var(--primary-600);
}
.toggle-slider {
position: absolute;
top: 2px;
left: 2px;
width: 20px;
height: 20px;
border-radius: 50%;
background: white;
transition: transform 0.2s;
box-shadow: 0 1px 3px rgba(0, 0, 0, 0.15);
}
.toggle-btn:disabled {
cursor: not-allowed;
opacity: 0.5;
}
.notif-divider {
height: 1px;
background: var(--border-primary);
margin: 20px 0 16px;
}
.notif-group-title {
font-size: 13px;
font-weight: 600;
color: var(--text-primary);
margin: 0 0 4px;
}
.notif-type-row {
margin-top: 14px;
}
.notif-type-row:first-of-type {
margin-top: 0;
}
.notif-disabled .toggle-label,
.notif-disabled .form-hint {
opacity: 0.6;
}
.notif-always-on {
flex-shrink: 0;
}
.toggle-btn.active .toggle-slider {
transform: translateX(20px);
}
.theme-options {
display: flex;
gap: 12px;
}
.theme-option {
display: flex;
flex-direction: column;
align-items: center;
gap: 8px;
padding: 16px 24px;
border: 2px solid var(--border-primary);
border-radius: var(--radius);
background: var(--bg-primary);
color: var(--text-secondary);
cursor: pointer;
transition: all var(--transition);
font-family: inherit;
min-width: 90px;
}
.theme-option:hover {
border-color: var(--primary-400);
color: var(--text-primary);
}
.theme-option.active {
border-color: var(--primary-600);
color: var(--primary-600);
background: var(--primary-50, rgba(79, 70, 229, 0.05));
}
.theme-option-icon {
display: flex;
align-items: center;
justify-content: center;
}
.theme-option-label {
font-size: 13px;
font-weight: 500;
}
.save-status {
display: inline-flex;
align-items: center;
gap: 6px;
font-size: 12px;
font-weight: 500;
color: var(--text-muted);
padding: 4px 10px;
border-radius: 999px;
background: var(--bg-secondary);
transition: opacity 0.2s, background 0.2s, color 0.2s;
}
.save-status-dot {
width: 6px;
height: 6px;
border-radius: 50%;
background: currentColor;
}
.save-status.saving {
color: var(--primary-600);
}
.save-status.saving .save-status-dot {
animation: save-status-pulse 1s ease-in-out infinite;
}
.save-status.saved {
color: var(--success-600, #16a34a);
}
.save-status.unsaved {
color: var(--text-secondary);
}
.save-status.error {
color: var(--danger-600);
background: var(--danger-50, rgba(220, 38, 38, 0.08));
}
@keyframes save-status-pulse {
0%, 100% { opacity: 0.4; }
50% { opacity: 1; }
}
</style>