universal-email-templates-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,135 @@
+# Universal Email Templates CLI
+
+CLI tools for building, translating, and exporting professional MJML email templates.
+
+## Features
+
+- Build MJML templates to HTML
+- Multi-language support (FR, EN, ES, DE, IT, PT, NL, AR)
+- Export to Mailchimp, Klaviyo, and HubSpot formats
+- WCAG 2.1 AAA accessibility compliant
+- Dark mode support
+
+## Installation
+
+```bash
+npm install -g universal-email-templates-cli
+```
+
+Or as a project dependency:
+
+```bash
+npm install universal-email-templates-cli
+```
+
+## CLI Usage
+
+### Build Templates
+
+```bash
+# Build all MJML templates to HTML
+email-build --src ./src/templates --dist ./dist/html
+
+# Build with options
+email-build --src ./src/templates --dist ./dist/html --minify
+```
+
+### Internationalization
+
+```bash
+# Build all languages
+email-i18n --all --src ./src/templates --dist ./dist/i18n
+
+# Build specific language
+email-i18n --lang fr --src ./src/templates --dist ./dist/i18n
+
+# Build with themes
+email-i18n --lang en --themed --src ./src/templates --dist ./dist/i18n
+```
+
+### Export to Platforms
+
+```bash
+# Export to Mailchimp
+email-export --platform mailchimp --src ./dist/html --dist ./dist/mailchimp
+
+# Export to Klaviyo
+email-export --platform klaviyo --src ./dist/html --dist ./dist/klaviyo
+
+# Export to HubSpot
+email-export --platform hubspot --src ./dist/html --dist ./dist/hubspot
+```
+
+## Programmatic Usage
+
+```javascript
+const { build, translate, exportTo } = require('universal-email-templates-cli');
+
+// Build templates
+await build({
+  src: './src/templates',
+  dist: './dist/html',
+  minify: true
+});
+
+// Translate templates
+await translate({
+  src: './src/templates',
+  dist: './dist/i18n',
+  languages: ['fr', 'en', 'es'],
+  translations: require('./config/translations')
+});
+
+// Export to platform
+await exportTo({
+  platform: 'mailchimp',
+  src: './dist/html',
+  dist: './dist/mailchimp'
+});
+```
+
+## Configuration
+
+### Translations
+
+Create a `translations.js` file:
+
+```javascript
+module.exports = {
+  en: {
+    greeting_hello: 'Hello',
+    btn_get_started: 'Get Started',
+    unsubscribe: 'Unsubscribe'
+  },
+  fr: {
+    greeting_hello: 'Bonjour',
+    btn_get_started: 'Commencer',
+    unsubscribe: 'Se desabonner'
+  }
+};
+```
+
+### Platform Variable Mappings
+
+| Our Variable | Mailchimp | Klaviyo | HubSpot |
+|--------------|-----------|---------|---------|
+| `{{first_name}}` | `*\|FNAME\|*` | `{{ first_name }}` | `{{ contact.firstname }}` |
+| `{{email}}` | `*\|EMAIL\|*` | `{{ email }}` | `{{ contact.email }}` |
+| `{{unsubscribe_url}}` | `*\|UNSUB\|*` | `{% unsubscribe_url %}` | `{{ unsubscribe_link }}` |
+
+## Supported Languages
+
+| Code | Language |
+|------|----------|
+| en | English |
+| fr | French |
+| es | Spanish |
+| de | German |
+| it | Italian |
+| pt | Portuguese |
+| nl | Dutch |
+| ar | Arabic |
+
+## License
+
+MIT

package/bin/build-i18n.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+
+/**
+ * CLI: Build templates with internationalization
+ * Usage: email-i18n --lang fr --src ./src --dist ./dist
+ */
+
+const path = require('path');
+const fs = require('fs');
+const { translate, DEFAULT_LANGUAGES } = require('../lib/translator');
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+
+function getArg(name, defaultValue) {
+  const index = args.indexOf(`--${name}`);
+  if (index !== -1 && args[index + 1]) {
+    return args[index + 1];
+  }
+  return defaultValue;
+}
+
+function hasFlag(name) {
+  return args.includes(`--${name}`) || args.includes(`-${name[0]}`);
+}
+
+// Show help
+if (hasFlag('help') || hasFlag('h')) {
+  console.log(`
+🌍 Universal Email Templates - i18n Build CLI
+
+Usage:
+  email-i18n [options]
+
+Options:
+  --all             Build all supported languages
+  --lang <code>     Build specific language (en, fr, es, de, it, pt, nl, ar)
+  --src <path>      Source directory with MJML files (default: ./src/templates)
+  --dist <path>     Destination directory (default: ./dist/i18n)
+  --config <path>   Path to translations.js config file
+  --silent          Suppress console output
+  --help, -h        Show this help message
+
+Supported Languages:
+  ${DEFAULT_LANGUAGES.join(', ')}
+
+Examples:
+  email-i18n --all
+  email-i18n --lang fr
+  email-i18n --lang en --src ./templates --dist ./output
+  email-i18n --all --config ./my-translations.js
+`);
+  process.exit(0);
+}
+
+// Load translations config
+let translations = {};
+const configPath = getArg('config', null);
+
+if (configPath) {
+  const fullConfigPath = path.resolve(configPath);
+  if (fs.existsSync(fullConfigPath)) {
+    translations = require(fullConfigPath);
+    console.log(`📖 Loaded translations from: ${fullConfigPath}\n`);
+  } else {
+    console.error(`❌ Config file not found: ${fullConfigPath}`);
+    process.exit(1);
+  }
+} else {
+  // Try to find translations.js in common locations
+  const possiblePaths = [
+    './config/translations.js',
+    './translations.js',
+    '../config/translations.js'
+  ];
+
+  for (const p of possiblePaths) {
+    const fullPath = path.resolve(p);
+    if (fs.existsSync(fullPath)) {
+      translations = require(fullPath);
+      console.log(`📖 Auto-loaded translations from: ${fullPath}\n`);
+      break;
+    }
+  }
+}
+
+// Determine languages to build
+let languages = DEFAULT_LANGUAGES;
+const specificLang = getArg('lang', null);
+
+if (specificLang) {
+  if (!DEFAULT_LANGUAGES.includes(specificLang)) {
+    console.error(`❌ Unsupported language: ${specificLang}`);
+    console.log(`Supported: ${DEFAULT_LANGUAGES.join(', ')}`);
+    process.exit(1);
+  }
+  languages = [specificLang];
+} else if (!hasFlag('all')) {
+  // Default to just English if no flag specified
+  languages = ['en'];
+}
+
+// Run translation build
+const options = {
+  src: getArg('src', './src/templates'),
+  dist: getArg('dist', './dist/i18n'),
+  languages,
+  translations,
+  silent: hasFlag('silent')
+};
+
+translate(options)
+  .then(results => {
+    const hasErrors = Object.values(results).some(r => r.errors > 0);
+    if (hasErrors) {
+      process.exit(1);
+    }
+  })
+  .catch(error => {
+    console.error('❌ i18n build failed:', error.message);
+    process.exit(1);
+  });

package/bin/build.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+/**
+ * CLI: Build MJML templates to HTML
+ * Usage: email-build --src ./src --dist ./dist
+ */
+
+const { build } = require('../lib/builder');
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+
+function getArg(name, defaultValue) {
+  const index = args.indexOf(`--${name}`);
+  if (index !== -1 && args[index + 1]) {
+    return args[index + 1];
+  }
+  return defaultValue;
+}
+
+function hasFlag(name) {
+  return args.includes(`--${name}`) || args.includes(`-${name[0]}`);
+}
+
+// Show help
+if (hasFlag('help') || hasFlag('h')) {
+  console.log(`
+📧 Universal Email Templates - Build CLI
+
+Usage:
+  email-build [options]
+
+Options:
+  --src <path>      Source directory with MJML files (default: ./src/templates)
+  --dist <path>     Destination directory for HTML (default: ./dist/html)
+  --minify          Minify output HTML
+  --silent          Suppress console output
+  --help, -h        Show this help message
+
+Examples:
+  email-build
+  email-build --src ./templates --dist ./output
+  email-build --minify
+`);
+  process.exit(0);
+}
+
+// Run build
+const options = {
+  src: getArg('src', './src/templates'),
+  dist: getArg('dist', './dist/html'),
+  minify: hasFlag('minify'),
+  silent: hasFlag('silent')
+};
+
+build(options)
+  .then(result => {
+    if (result.errors > 0) {
+      process.exit(1);
+    }
+  })
+  .catch(error => {
+    console.error('❌ Build failed:', error.message);
+    process.exit(1);
+  });

package/bin/export.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+
+/**
+ * CLI: Export templates to email platforms
+ * Usage: email-export --platform mailchimp --src ./dist/html --dist ./dist/mailchimp
+ */
+
+const { exportTo, exportAll, platforms } = require('../lib/exporter');
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+
+function getArg(name, defaultValue) {
+  const index = args.indexOf(`--${name}`);
+  if (index !== -1 && args[index + 1]) {
+    return args[index + 1];
+  }
+  return defaultValue;
+}
+
+function hasFlag(name) {
+  return args.includes(`--${name}`) || args.includes(`-${name[0]}`);
+}
+
+const supportedPlatforms = Object.keys(platforms);
+
+// Show help
+if (hasFlag('help') || hasFlag('h')) {
+  console.log(`
+📤 Universal Email Templates - Export CLI
+
+Usage:
+  email-export --platform <name> [options]
+
+Options:
+  --platform <name>   Target platform: ${supportedPlatforms.join(', ')}
+  --all               Export to all platforms
+  --src <path>        Source directory with HTML files (default: ./dist/html)
+  --dist <path>       Destination directory (default: ./dist/<platform>)
+  --silent            Suppress console output
+  --help, -h          Show this help message
+
+Supported Platforms:
+  mailchimp   - Mailchimp merge tags (*|FNAME|*, etc.)
+  klaviyo     - Klaviyo template tags ({{ first_name }}, etc.)
+  hubspot     - HubSpot personalization tokens ({{ contact.firstname }}, etc.)
+
+Examples:
+  email-export --platform mailchimp
+  email-export --platform klaviyo --src ./html --dist ./klaviyo
+  email-export --all
+`);
+  process.exit(0);
+}
+
+// Run export
+async function run() {
+  const src = getArg('src', './dist/html');
+  const silent = hasFlag('silent');
+
+  if (hasFlag('all')) {
+    // Export to all platforms
+    console.log('🚀 Exporting to all platforms...\n');
+
+    const results = await exportAll({ src, silent });
+
+    console.log('\n' + '='.repeat(50));
+    console.log('📊 Export Summary:');
+    console.log('='.repeat(50));
+
+    let totalSuccess = 0;
+    let totalErrors = 0;
+
+    for (const [platform, result] of Object.entries(results)) {
+      console.log(`  ${platforms[platform].name}: ${result.success} success, ${result.errors} errors`);
+      totalSuccess += result.success;
+      totalErrors += result.errors;
+    }
+
+    console.log('='.repeat(50));
+    console.log(`  TOTAL: ${totalSuccess} success, ${totalErrors} errors\n`);
+
+    if (totalErrors > 0) {
+      process.exit(1);
+    }
+  } else {
+    // Export to specific platform
+    const platform = getArg('platform', null);
+
+    if (!platform) {
+      console.error('❌ Please specify a platform with --platform <name>');
+      console.log(`Supported: ${supportedPlatforms.join(', ')}`);
+      console.log('Or use --all to export to all platforms');
+      process.exit(1);
+    }
+
+    if (!supportedPlatforms.includes(platform)) {
+      console.error(`❌ Unsupported platform: ${platform}`);
+      console.log(`Supported: ${supportedPlatforms.join(', ')}`);
+      process.exit(1);
+    }
+
+    const dist = getArg('dist', `./dist/${platform}`);
+
+    const result = await exportTo({ platform, src, dist, silent });
+
+    if (result.errors > 0) {
+      process.exit(1);
+    }
+  }
+}
+
+run().catch(error => {
+  console.error('❌ Export failed:', error.message);
+  process.exit(1);
+});

package/config/translations.example.js

@@ -0,0 +1,110 @@
+/**
+ * Example translations configuration
+ * Copy this file to translations.js and customize
+ */
+
+module.exports = {
+  en: {
+    // Greetings
+    greeting_hello: 'Hello',
+    greeting_hi: 'Hi',
+    greeting_dear: 'Dear',
+    greeting_welcome: 'Welcome',
+    welcome_aboard: 'Welcome aboard!',
+
+    // Buttons
+    btn_get_started: 'Get Started',
+    btn_learn_more: 'Learn More',
+    btn_shop_now: 'Shop Now',
+    btn_view_details: 'View Details',
+    btn_subscribe: 'Subscribe',
+    btn_confirm: 'Confirm',
+    btn_reset_password: 'Reset Password',
+    btn_verify_email: 'Verify Email',
+    btn_view_order: 'View Order',
+    btn_track_order: 'Track Order',
+
+    // Common UI
+    view_in_browser: 'View in browser',
+    unsubscribe: 'Unsubscribe',
+    privacy_policy: 'Privacy Policy',
+    terms_of_service: 'Terms of Service',
+    contact_us: 'Contact Us',
+    all_rights_reserved: 'All rights reserved',
+
+    // Order related
+    order_number: 'Order Number',
+    order_date: 'Order Date',
+    order_total: 'Total',
+    order_subtotal: 'Subtotal',
+    order_shipping: 'Shipping',
+    order_tax: 'Tax',
+    shipping_address: 'Shipping Address',
+    billing_address: 'Billing Address',
+
+    // Common phrases
+    thank_you: 'Thank you',
+    questions_reply: 'Questions? Just reply to this email.'
+  },
+
+  fr: {
+    // Greetings
+    greeting_hello: 'Bonjour',
+    greeting_hi: 'Salut',
+    greeting_dear: 'Cher',
+    greeting_welcome: 'Bienvenue',
+    welcome_aboard: 'Bienvenue parmi nous !',
+
+    // Buttons
+    btn_get_started: 'Commencer',
+    btn_learn_more: 'En savoir plus',
+    btn_shop_now: 'Acheter maintenant',
+    btn_view_details: 'Voir les details',
+    btn_subscribe: "S'abonner",
+    btn_confirm: 'Confirmer',
+    btn_reset_password: 'Reinitialiser le mot de passe',
+    btn_verify_email: "Verifier l'email",
+    btn_view_order: 'Voir la commande',
+    btn_track_order: 'Suivre la commande',
+
+    // Common UI
+    view_in_browser: 'Voir dans le navigateur',
+    unsubscribe: 'Se desabonner',
+    privacy_policy: 'Politique de confidentialite',
+    terms_of_service: "Conditions d'utilisation",
+    contact_us: 'Nous contacter',
+    all_rights_reserved: 'Tous droits reserves',
+
+    // Order related
+    order_number: 'Numero de commande',
+    order_date: 'Date de commande',
+    order_total: 'Total',
+    order_subtotal: 'Sous-total',
+    order_shipping: 'Livraison',
+    order_tax: 'TVA',
+    shipping_address: 'Adresse de livraison',
+    billing_address: 'Adresse de facturation',
+
+    // Common phrases
+    thank_you: 'Merci',
+    questions_reply: 'Des questions ? Repondez simplement a cet email.'
+  },
+
+  es: {
+    greeting_hello: 'Hola',
+    greeting_welcome: 'Bienvenido',
+    btn_get_started: 'Comenzar',
+    btn_learn_more: 'Saber mas',
+    unsubscribe: 'Darse de baja',
+    thank_you: 'Gracias'
+  },
+
+  de: {
+    greeting_hello: 'Hallo',
+    greeting_welcome: 'Willkommen',
+    btn_get_started: 'Loslegen',
+    btn_learn_more: 'Mehr erfahren',
+    unsubscribe: 'Abmelden',
+    thank_you: 'Danke'
+  }
+};

package/index.js

@@ -0,0 +1,23 @@
+/**
+ * Universal Email Templates CLI
+ * Build, translate, and export MJML email templates
+ */
+
+const { build } = require('./lib/builder');
+const { translate, applyTranslations } = require('./lib/translator');
+const { exportTo, platforms } = require('./lib/exporter');
+
+module.exports = {
+  // Main functions
+  build,
+  translate,
+  exportTo,
+
+  // Utilities
+  applyTranslations,
+  platforms,
+
+  // Constants
+  supportedLanguages: ['en', 'fr', 'es', 'de', 'it', 'pt', 'nl', 'ar'],
+  supportedPlatforms: ['mailchimp', 'klaviyo', 'hubspot']
+};

package/lib/builder.js

@@ -0,0 +1,109 @@
+/**
+ * MJML Build Functions
+ * Compiles MJML templates to HTML
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs-extra');
+const path = require('path');
+const glob = require('glob');
+
+/**
+ * Build MJML templates to HTML
+ * @param {Object} options - Build options
+ * @param {string} options.src - Source directory with MJML files
+ * @param {string} options.dist - Destination directory for HTML files
+ * @param {boolean} [options.minify=false] - Minify output HTML
+ * @param {boolean} [options.silent=false] - Suppress console output
+ * @returns {Promise<{success: number, errors: number, files: string[]}>}
+ */
+async function build(options = {}) {
+  const {
+    src = './src/templates',
+    dist = './dist/html',
+    minify = false,
+    silent = false
+  } = options;
+
+  const srcDir = path.resolve(src);
+  const distDir = path.resolve(dist);
+
+  // Ensure dist directory exists
+  await fs.ensureDir(distDir);
+
+  // Find all MJML files
+  const mjmlFiles = glob.sync('**/*.mjml', { cwd: srcDir });
+
+  if (!silent) {
+    console.log(`\n🚀 Building ${mjmlFiles.length} MJML templates...\n`);
+  }
+
+  let successCount = 0;
+  let errorCount = 0;
+  const processedFiles = [];
+
+  for (const file of mjmlFiles) {
+    const inputPath = path.join(srcDir, file);
+    const outputPath = path.join(distDir, file.replace('.mjml', '.html'));
+    const outputDir = path.dirname(outputPath);
+
+    // Ensure output subdirectory exists
+    await fs.ensureDir(outputDir);
+
+    try {
+      const minifyFlag = minify ? '--config.minify=true' : '';
+      execSync(`npx mjml "${inputPath}" -o "${outputPath}" ${minifyFlag}`, {
+        stdio: 'pipe'
+      });
+
+      if (!silent) {
+        console.log(`✅ ${file}`);
+      }
+
+      successCount++;
+      processedFiles.push(outputPath);
+    } catch (error) {
+      if (!silent) {
+        console.log(`❌ ${file}`);
+        console.log(`   Error: ${error.message}`);
+      }
+      errorCount++;
+    }
+  }
+
+  if (!silent) {
+    console.log(`\n📊 Build complete: ${successCount} success, ${errorCount} errors`);
+    console.log(`📁 Output: ${distDir}\n`);
+  }
+
+  return {
+    success: successCount,
+    errors: errorCount,
+    files: processedFiles
+  };
+}
+
+/**
+ * Build a single MJML file
+ * @param {string} inputPath - Path to MJML file
+ * @param {string} outputPath - Path for output HTML
+ * @param {Object} [options] - Build options
+ * @returns {Promise<string>} - Output HTML content
+ */
+async function buildSingle(inputPath, outputPath, options = {}) {
+  const { minify = false } = options;
+
+  await fs.ensureDir(path.dirname(outputPath));
+
+  const minifyFlag = minify ? '--config.minify=true' : '';
+  execSync(`npx mjml "${inputPath}" -o "${outputPath}" ${minifyFlag}`, {
+    stdio: 'pipe'
+  });
+
+  return fs.readFile(outputPath, 'utf8');
+}
+
+module.exports = {
+  build,
+  buildSingle
+};

package/lib/exporter.js

@@ -0,0 +1,201 @@
+/**
+ * Platform Export Functions
+ * Convert templates to Mailchimp, Klaviyo, HubSpot formats
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+const glob = require('glob');
+const cheerio = require('cheerio');
+
+/**
+ * Platform-specific variable mappings
+ */
+const platforms = {
+  mailchimp: {
+    name: 'Mailchimp',
+    variables: {
+      '{{first_name}}': '*|FNAME|*',
+      '{{last_name}}': '*|LNAME|*',
+      '{{email}}': '*|EMAIL|*',
+      '{{company_name}}': '*|LIST:COMPANY|*',
+      '{{company_address}}': '*|LIST:ADDRESS|*',
+      '{{unsubscribe_url}}': '*|UNSUB|*',
+      '{{preferences_url}}': '*|UPDATE_PROFILE|*',
+      '{{view_in_browser}}': '*|ARCHIVE|*',
+      '{{current_year}}': '*|CURRENT_YEAR|*',
+      '{{forward_url}}': '*|FORWARD|*'
+    },
+    trackingPixel: '<img src="*|OPEN_TRACKING_URL|*" width="1" height="1" style="display:none;">'
+  },
+
+  klaviyo: {
+    name: 'Klaviyo',
+    variables: {
+      '{{first_name}}': '{{ first_name|default:"" }}',
+      '{{last_name}}': '{{ last_name|default:"" }}',
+      '{{email}}': '{{ email }}',
+      '{{company_name}}': '{{ organization.name }}',
+      '{{company_address}}': '{{ organization.address }}',
+      '{{unsubscribe_url}}': '{% unsubscribe_url %}',
+      '{{preferences_url}}': '{% manage_preferences_url %}',
+      '{{view_in_browser}}': '{% view_in_browser_url %}',
+      '{{current_year}}': '{{ "now"|date:"Y" }}'
+    },
+    trackingPixel: null
+  },
+
+  hubspot: {
+    name: 'HubSpot',
+    variables: {
+      '{{first_name}}': '{{ contact.firstname }}',
+      '{{last_name}}': '{{ contact.lastname }}',
+      '{{email}}': '{{ contact.email }}',
+      '{{company_name}}': '{{ site_settings.company_name }}',
+      '{{company_address}}': '{{ site_settings.company_street_address_1 }}',
+      '{{unsubscribe_url}}': '{{ unsubscribe_link }}',
+      '{{preferences_url}}': '{{ unsubscribe_link }}',
+      '{{view_in_browser}}': '{{ view_as_page_url }}',
+      '{{current_year}}': '{{ year }}'
+    },
+    trackingPixel: null
+  }
+};
+
+/**
+ * Escape regex special characters
+ */
+function escapeRegex(string) {
+  return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+/**
+ * Export templates to a specific platform format
+ * @param {Object} options - Export options
+ * @param {string} options.platform - Target platform (mailchimp, klaviyo, hubspot)
+ * @param {string} options.src - Source directory with HTML files
+ * @param {string} options.dist - Destination directory
+ * @param {boolean} [options.silent=false] - Suppress console output
+ * @returns {Promise<{success: number, errors: number, files: string[]}>}
+ */
+async function exportTo(options = {}) {
+  const {
+    platform,
+    src = './dist/html',
+    dist,
+    silent = false
+  } = options;
+
+  if (!platform || !platforms[platform]) {
+    throw new Error(`Invalid platform. Supported: ${Object.keys(platforms).join(', ')}`);
+  }
+
+  const platformConfig = platforms[platform];
+  const srcDir = path.resolve(src);
+  const distDir = path.resolve(dist || `./dist/${platform}`);
+
+  if (!silent) {
+    console.log(`🚀 Starting ${platformConfig.name} export...\n`);
+  }
+
+  // Ensure destination directory exists
+  await fs.ensureDir(distDir);
+
+  // Get all HTML files
+  const htmlFiles = glob.sync('**/*.html', { cwd: srcDir });
+
+  if (htmlFiles.length === 0) {
+    if (!silent) {
+      console.log('⚠️  No HTML files found. Run build first.\n');
+    }
+    return { success: 0, errors: 0, files: [] };
+  }
+
+  if (!silent) {
+    console.log(`📁 Found ${htmlFiles.length} templates to convert\n`);
+  }
+
+  let successCount = 0;
+  let errorCount = 0;
+  const processedFiles = [];
+
+  for (const file of htmlFiles) {
+    const sourcePath = path.join(srcDir, file);
+    const destPath = path.join(distDir, file);
+
+    try {
+      // Read HTML content
+      let html = await fs.readFile(sourcePath, 'utf8');
+
+      // Replace variables with platform-specific tags
+      for (const [ourVar, platformVar] of Object.entries(platformConfig.variables)) {
+        html = html.replace(new RegExp(escapeRegex(ourVar), 'g'), platformVar);
+      }
+
+      // Add tracking pixel if needed (Mailchimp)
+      if (platformConfig.trackingPixel) {
+        const $ = cheerio.load(html);
+        if (!$('img[src*="TRACKING"]').length && !$('img[src*="tracking"]').length) {
+          $('body').append(platformConfig.trackingPixel);
+        }
+        html = $.html();
+      }
+
+      // Ensure destination subdirectory exists
+      await fs.ensureDir(path.dirname(destPath));
+
+      // Write converted file
+      await fs.writeFile(destPath, html);
+
+      if (!silent) {
+        console.log(`✅ ${file}`);
+      }
+
+      successCount++;
+      processedFiles.push(destPath);
+    } catch (error) {
+      if (!silent) {
+        console.log(`❌ ${file}`);
+        console.log(`   Error: ${error.message}`);
+      }
+      errorCount++;
+    }
+  }
+
+  if (!silent) {
+    console.log(`\n🎉 ${platformConfig.name} export complete!`);
+    console.log(`📁 Files saved to: ${distDir}\n`);
+  }
+
+  return {
+    success: successCount,
+    errors: errorCount,
+    files: processedFiles
+  };
+}
+
+/**
+ * Export to all platforms at once
+ */
+async function exportAll(options = {}) {
+  const { src, distBase = './dist', silent = false } = options;
+  const results = {};
+
+  for (const platform of Object.keys(platforms)) {
+    results[platform] = await exportTo({
+      platform,
+      src,
+      dist: path.join(distBase, platform),
+      silent
+    });
+  }
+
+  return results;
+}
+
+module.exports = {
+  exportTo,
+  exportAll,
+  platforms,
+  escapeRegex
+};

package/lib/translator.js

@@ -0,0 +1,220 @@
+/**
+ * Translation Functions
+ * Apply translations to MJML/HTML templates
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs-extra');
+const path = require('path');
+const glob = require('glob');
+
+// Default supported languages
+const DEFAULT_LANGUAGES = ['en', 'fr', 'es', 'de', 'it', 'pt', 'nl', 'ar'];
+
+/**
+ * Get translation value
+ * @param {Object} translations - Translation object
+ * @param {string} key - Translation key
+ * @param {string} lang - Language code
+ * @returns {string} - Translated text
+ */
+function t(translations, key, lang) {
+  if (translations[lang] && translations[lang][key]) {
+    return translations[lang][key];
+  }
+  if (translations.en && translations.en[key]) {
+    return translations.en[key];
+  }
+  return `{{t.${key}}}`;
+}
+
+/**
+ * Apply translations to content
+ * @param {string} content - MJML or HTML content
+ * @param {string} lang - Target language
+ * @param {Object} translations - Translation dictionary
+ * @returns {string} - Translated content
+ */
+function applyTranslations(content, lang, translations) {
+  let result = content;
+
+  // Replace {{t:key}} and {{t.key}} patterns
+  const translationPatternColon = /\{\{t:(\w+)\}\}/g;
+  const translationPatternDot = /\{\{t\.(\w+)\}\}/g;
+
+  result = result.replace(translationPatternColon, (match, key) => {
+    return t(translations, key, lang);
+  });
+
+  result = result.replace(translationPatternDot, (match, key) => {
+    return t(translations, key, lang);
+  });
+
+  return result;
+}
+
+/**
+ * Translate templates to multiple languages
+ * @param {Object} options - Translation options
+ * @param {string} options.src - Source directory with MJML files
+ * @param {string} options.dist - Destination directory
+ * @param {string[]} [options.languages] - Languages to build
+ * @param {Object} options.translations - Translation dictionary
+ * @param {Object} [options.themes] - Theme configurations
+ * @param {boolean} [options.silent=false] - Suppress console output
+ * @returns {Promise<Object>} - Results by language
+ */
+async function translate(options = {}) {
+  const {
+    src = './src/templates',
+    dist = './dist/i18n',
+    languages = DEFAULT_LANGUAGES,
+    translations = {},
+    themes = null,
+    silent = false
+  } = options;
+
+  const srcDir = path.resolve(src);
+  const distDir = path.resolve(dist);
+  const results = {};
+
+  if (!silent) {
+    console.log(`🚀 Building templates in ${languages.length} languages: ${languages.join(', ')}...\n`);
+  }
+
+  for (const lang of languages) {
+    results[lang] = await buildLanguage({
+      lang,
+      srcDir,
+      distDir,
+      translations,
+      themes,
+      silent
+    });
+  }
+
+  if (!silent) {
+    console.log('\n' + '='.repeat(50));
+    console.log('📊 All languages build summary:');
+    console.log('='.repeat(50));
+
+    let totalSuccess = 0;
+    let totalErrors = 0;
+
+    for (const [lang, result] of Object.entries(results)) {
+      console.log(`  ${lang.toUpperCase()}: ${result.success} success, ${result.errors} errors`);
+      totalSuccess += result.success;
+      totalErrors += result.errors;
+    }
+
+    console.log('='.repeat(50));
+    console.log(`  TOTAL: ${totalSuccess} success, ${totalErrors} errors\n`);
+  }
+
+  return results;
+}
+
+/**
+ * Build templates for a specific language
+ */
+async function buildLanguage(options) {
+  const { lang, srcDir, distDir, translations, themes, silent } = options;
+
+  const langDir = path.join(distDir, lang);
+  const tempDir = path.join(distDir, '.temp-i18n');
+
+  // Ensure directories exist
+  await fs.ensureDir(langDir);
+  await fs.remove(tempDir);
+  await fs.ensureDir(tempDir);
+
+  // Find all MJML files
+  const mjmlFiles = glob.sync('**/*.mjml', { cwd: srcDir });
+
+  if (!silent) {
+    console.log(`\n🌍 Building ${mjmlFiles.length} templates in ${lang.toUpperCase()}...\n`);
+  }
+
+  let successCount = 0;
+  let errorCount = 0;
+
+  for (const file of mjmlFiles) {
+    const inputPath = path.join(srcDir, file);
+    const tempPath = path.join(tempDir, file);
+    const outputPath = path.join(langDir, file.replace('.mjml', '.html'));
+
+    await fs.ensureDir(path.dirname(tempPath));
+    await fs.ensureDir(path.dirname(outputPath));
+
+    try {
+      // Read and translate MJML
+      let mjmlContent = await fs.readFile(inputPath, 'utf-8');
+      mjmlContent = applyTranslations(mjmlContent, lang, translations);
+
+      // Apply theme if provided
+      if (themes) {
+        mjmlContent = applyTheme(mjmlContent, themes);
+      }
+
+      // Write temp file
+      await fs.writeFile(tempPath, mjmlContent);
+
+      // Build MJML to HTML
+      execSync(`npx mjml "${tempPath}" -o "${outputPath}"`, { stdio: 'pipe' });
+
+      if (!silent) {
+        console.log(`✅ ${file}`);
+      }
+      successCount++;
+    } catch (error) {
+      if (!silent) {
+        console.log(`❌ ${file}`);
+        console.log(`   Error: ${error.message}`);
+      }
+      errorCount++;
+    }
+  }
+
+  // Clean up temp directory
+  await fs.remove(tempDir);
+
+  if (!silent) {
+    console.log(`\n📊 Build complete: ${successCount} success, ${errorCount} errors`);
+  }
+
+  return { success: successCount, errors: errorCount };
+}
+
+/**
+ * Apply theme colors to content
+ */
+function applyTheme(content, themeColors) {
+  let result = content;
+
+  const colorMappings = {
+    '#3B82F6': themeColors.primary,
+    '#2563EB': themeColors.primary_dark,
+    '#DBEAFE': themeColors.primary_light,
+    '#1F2937': themeColors.text_primary,
+    '#4B5563': themeColors.text_secondary,
+    '#FFFFFF': themeColors.surface,
+    '#F9FAFB': themeColors.background
+  };
+
+  for (const [original, replacement] of Object.entries(colorMappings)) {
+    if (replacement) {
+      const regex = new RegExp(original.replace('#', '\\#'), 'gi');
+      result = result.replace(regex, replacement);
+    }
+  }
+
+  return result;
+}
+
+module.exports = {
+  translate,
+  applyTranslations,
+  buildLanguage,
+  applyTheme,
+  DEFAULT_LANGUAGES
+};

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "universal-email-templates-cli",
+  "version": "1.0.0",
+  "description": "CLI tools for building, translating and exporting professional MJML email templates to Mailchimp, Klaviyo, and HubSpot",
+  "author": "Atsé Fabrice Igor KOMAN <your.email@example.com>",
+  "license": "MIT",
+  "main": "index.js",
+  "bin": {
+    "email-build": "./bin/build.js",
+    "email-i18n": "./bin/build-i18n.js",
+    "email-export": "./bin/export.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "config/",
+    "index.js",
+    "README.md"
+  ],
+  "keywords": [
+    "email-templates",
+    "mjml",
+    "newsletter",
+    "mailchimp",
+    "klaviyo",
+    "hubspot",
+    "email-marketing",
+    "responsive-email",
+    "i18n",
+    "internationalization",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NumeriKStudio/universal-email-templates-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/NumeriKStudio/universal-email-templates-cli/issues"
+  },
+  "homepage": "https://github.com/NumeriKStudio/universal-email-templates-cli#readme",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "scripts": {
+    "build": "node bin/build.js",
+    "build:i18n": "node bin/build-i18n.js --all",
+    "build:lang": "node bin/build-i18n.js",
+    "export:mailchimp": "node bin/export.js --platform mailchimp",
+    "export:klaviyo": "node bin/export.js --platform klaviyo",
+    "export:hubspot": "node bin/export.js --platform hubspot",
+    "test": "node test/index.js",
+    "prepublishOnly": "npm test"
+  },
+  "dependencies": {
+    "cheerio": "^1.0.0-rc.12",
+    "fs-extra": "^11.2.0",
+    "glob": "^10.3.10",
+    "mjml": "^4.15.3"
+  },
+  "devDependencies": {
+    "jest": "^29.7.0"
+  }
+}