Skip to content

v0.2.0

Choose a tag to compare

@ryanhefner ryanhefner released this 15 Sep 19:12
· 59 commits to main since this release
a8a0031

Chakra Email v0.2.0

Chakra Email v0.2.0 introduces themeable component recipes, safer rendering controls, three new integration packages, and a redesigned preview workspace.

New packages

  • @chakra-email/markdown — email-safe GitHub Flavored Markdown, including tables, task lists, and fenced code blocks. Supports customizable components and schema-validated, non-executable directives.
  • @chakra-email/code-block — themeable code blocks with optional line numbers and pluggable syntax highlighting.
  • @chakra-email/react-email — optional React Email renderer integration for Chakra Email tooling.

Components and rendering

  • Component recipes and multipart slot recipes for theme-level customization.
  • Single-pass renderEmail() output for HTML and plaintext.
  • Extensible renderer adapters and a theme-aware Font component.
  • Improved semantic-token resolution and authored light/dark styles across Chakra v2/v3 integrations.
  • Automatic removal of React 19 image preload hints from email output.

A refined preview workspace

  • Full-viewport layout with collapsible panels and a resizable email canvas.
  • Chakra UI v3 controls, accessible icon actions, tooltips, and keyboard-navigable output tabs.
  • A permanently dark workspace with an independent light/dark email toggle.
  • Deterministic exports, compatibility linting, and opt-in network link checks.
  • Template-derived subjects and provider-neutral test sending.
  • Explicit reverse-proxy host allowlisting for local development.

Preview-only styling does not alter copied, downloaded, or delivered email output.

Security and developer experience

  • Configurable URL policies, strict presets, and typed, content-free rendering errors.
  • Optional UTF-8 output limits and Markdown source, line-count, node-count, and nesting limits.
  • Hardened URL and preview-host validation.
  • Focused theme/security entry points and declaration-performance regression checks.
  • Expanded examples, composition guidance, and a reusable Chakra Email skill.

Upgrading

Update the Chakra Email packages you use together to 0.2.0.

  • Img.srcSet is no longer supported. Use a single policy-validated src.
  • The preview’s previous System/Light/Dark selector is replaced by the header email toggle. Explicit preferences persist; previous System preferences default to Light.
  • React Email remains optional. Configure strict URL policies and content limits explicitly when rendering untrusted content.
  • Authored dark-mode support does not simulate every email client’s automatic color inversion.

Full changelog: v0.1.0...v0.2.0