Foma Render Engine

A micro-service for high-fidelity email rendering. It interprets the proprietary .fre format — a simplified HTML/CSS template syntax — and produces emails that render identically across Outlook, Gmail, Apple Mail and mobile clients.

Highlights

• Interprets the proprietary .fre format (Foma Render Extension)
• Compatible with all major email clients — Outlook, Gmail, Apple Mail, mobile
• Automatic CSS inlining powered by Juice, for 100% client compatibility
• Handlebars integration for dynamic data injection (personalization)
• Centralized layout — one layout.fre for consistent branding across services
• Dockerized — ready to deploy with Node 22 Alpine
• Used across the Fordima Inc. ecosystem (FomaBank, Dzoket, and others)

Architecture

Layer	Technology
Runtime	Node.js 22
Framework	Fastify
Template engine	Handlebars
CSS inlining	Juice
Container	Docker (Node 22 Alpine)

Included templates

• layout.fre — the global Foma branded framework, shared across all services
• otp.fre — security-first verification code template
• welcome.fre — onboarding template for new users

How it works

A typical render request takes a template name, a data payload, and returns the final HTML email with every style inlined:

POST /render
{
  "template": "otp",
  "data": {
    "code": "482 913",
    "expiresIn": "10 minutes"
  }
}