@templatical/editor

@templatical/editor

Vue 3 visual drag-and-drop email editor — drop into any web app with one function call.

The visual editor for Templatical — a source-available drag-and-drop email editor with JSON templates and MJML output.

• 🧩 14 block types — title, paragraph, image, button, section, divider, spacer, social icons, menu, table, HTML, video, countdown, custom
• 🛡 Shadow DOM isolated — mounts inside an open shadow root by default so host page CSS cannot bleed in
• 🎨 Full theming via design tokens — --tpl-user-* CSS variables, dark mode, custom fonts
• 🔌 Framework-agnostic — works in React, Vue, Svelte, Angular, vanilla
• 📦 JSON in, MJML out — portable templates, render with any email provider
• 🌍 Multilingual — English, German, Portuguese, Spanish, Catalan, French, Dutch & Japanese built in
• 🔒 TypeScript strict — full type safety end to end

Install

npm install @templatical/editor

@templatical/renderer is an optional peer — install it only if you need to convert templates to MJML. The two common cases are:

• In the browser, alongside the editor, when you call editor.toMjml() to export from the user's session.
• In Node.js (or another runtime), when you only have stored template JSON and want to convert it to MJML server-side. You don't need the editor for this — install just the renderer.

npm install @templatical/renderer

If you call editor.toMjml() without the renderer installed, it throws a clear error naming the missing package.

Usage

import { init } from '@templatical/editor';
import '@templatical/editor/style.css';

const editor = await init({
  container: '#editor',
  onChange(content) {
    // content is JSON — store/version/sync however you want
  },
});

// Render to MJML when sending email — async; requires @templatical/renderer
const mjml = await editor.toMjml();

// Always unmount when removing the editor (cleans up listeners + DOM)
editor.unmount();

<div id="editor" style="height: 100vh"></div>

Framework integration

First-class examples for React, Vue, Svelte, Angular, and vanilla JS are in the installation guide.

Shadow DOM by default

The editor mounts inside an open shadow root attached to your container. Host page CSS — including resets like * { color: red !important } — cannot cascade into editor elements, and editor utility classes cannot leak out.

// Shadow DOM is on by default — no extra config
const editor = await init({ container: "#editor" });

// Opt out for light-DOM mount (older browsers, host-side document.querySelector access)
const editor = await init({ container: "#editor", shadowDom: false });

Theme via :host-style CSS variables — set --tpl-user-* on the container (or any ancestor) and the value inherits across the shadow boundary:

#editor {
  --tpl-user-primary: oklch(65% 0.2 280);
  --tpl-user-radius: 14px;
}

See the Shadow DOM guide for trade-offs, opt-out semantics, and browser-support tiers.

Cloud features

AI rewrite goes through initCloud(). Comments, version history, saved blocks, test email, rendering and real-time collaboration are not Cloud-only — configure each against your own backend with init(). See Connect your backend.

Documentation

• Quick Start
• Editor API reference
• Block reference
• Theming
• Shadow DOM
• Custom blocks
• Saved blocks

Full docs at docs.templatical.com.

License

FSL-1.1-MIT — free for any non-competing commercial use, automatically converts to MIT after 2 years per release. License FAQ.