Handlebars Templating Standards

The "Logic-less" Philosophy

1. Data Preparation: Templates should strictly DISPLAY data. All filtering, sorting, or complex math MUST happen in the application code (Controller/Service) before the data reaches the template.
2. Avoid Spaghettis: If you need more than two nested {{#if}} or {{#each}} blocks, consider refactoring the data structure or creating a custom helper.

Syntax & Helpers

1. Escaping:
   • Default {{ value }} is safe and escapes HTML characters.
   • Use {{{ value }}} (triple-stash) ONLY for trusted HTML strings (e.g., pre-sanitized content).
2. Custom Helpers:
   • Do not write complex inline logic. Instead of {{#if (eq (mod index 2) 0)}}, create a helper {{#if (isEven index)}} or, better yet, pre-calculate isEven in the data model.
   • Register helpers for formatting dates, currencies, and translation.