Client Reference

interface EmailClient {
  id: string;
  name: string;
  category: "webmail" | "desktop" | "mobile";
  engine: string;
  darkModeSupport: boolean;
  icon: string;
  deprecated?: string; // e.g. "2026-10" — YYYY-MM format
}

import { EMAIL_CLIENTS, getClient } from "@emailens/engine";

// All clients
for (const client of EMAIL_CLIENTS) {
  console.log(`${client.id}: ${client.name} (${client.engine})`);
}

// Single client by ID
const outlook = getClient("outlook-windows");
// { id: "outlook-windows", name: "Outlook (New)", category: "desktop", engine: "Outlook Web", darkModeSupport: true, icon: "monitor" }

const legacyOutlook = getClient("outlook-windows-legacy");
// { id: "outlook-windows-legacy", name: "Outlook Classic", ..., deprecated: "2026-10" }

// Filter by category
const mobileClients = EMAIL_CLIENTS.filter((c) => c.category === "mobile");
// gmail-android, gmail-ios, apple-mail-ios, samsung-mail

// Filter by dark mode support
const darkModeClients = EMAIL_CLIENTS.filter((c) => c.darkModeSupport);
// All 13 clients support dark mode

// Filter out deprecated clients
const activeClients = EMAIL_CLIENTS.filter((c) => !c.deprecated);