Skip to main content

​
Introduction

The template engine is a core feature of Compozy that allows you to:
  • Reference data from various workflow components
  • Perform dynamic calculations and transformations
  • Access environment variables and configuration
  • Handle conditional logic inline
Compozy uses Jinja2-style syntax combined with Deno for JavaScript evaluation, providing:
  • Simple expressions using {{ ... }} for single-line JavaScript
  • Complex logic using $exec: | for multiline JavaScript code
Since we use Deno runtime, all JavaScript code in templates follows modern ECMAScript standards and has access to Deno’s built-in security features.

​
Template Syntax

​
Simple Expressions

For basic operations, use the {{ ... }} syntax. These expressions should be concise and focus on a single operation: 
# Basic variable access
name: "{{ user.name }}"

# Simple calculations
total: "{{ price * quantity }}"

# Conditional values
status: "{{ isActive ? 'running' : 'stopped' }}"

​
Multiline Code

For complex operations that require multiple lines or intermediate variables, use the $exec: | syntax: 
description:
  $exec: |
    const { title, author, date } = metadata;
    const formattedDate = new Date(date).toLocaleDateString();
    return `${title} by ${author} (${formattedDate})`;

​
Working with Objects and Arrays

# Property access
value: "{{ object.nested.property }}"

# Optional chaining
value: "{{ object?.nested?.property }}"

# Default values
value: "{{ object.property ?? 'default' }}"

​
Built-in Functions

Compozy includes several popular libraries for common operations. Here are some examples: 
# Lodash array utilities
chunks: "{{ _.chunk(array, 2) }}"

# String manipulation
slug: "{{ v.slugify(title) }}"
For a complete reference of available functions, see Template Functions.

​
Custom Dependencies

You can extend the template engine with additional libraries. All custom dependencies are automatically namespaced under the $ object: 
---
name: "My Document"
template-dependencies:
  - package: "npm:[email protected]"
    name: math
---

# Access custom dependencies through the $ object
result: "{{ $.math.evaluate('2x + 3y', { x: 4, y: 2 }) }}"
Learn more about adding custom dependencies in Custom Dependencies.

​
Best Practices

1

Keep Expressions Simple

Use simple expressions for basic operations:
status: "{{ isActive && isValid }}"
Move complex logic to multiline blocks:
status:
  $exec: |
    if (!isActive) return 'inactive';
    if (!isValid) return 'invalid';
    return 'ready';
2

Use Optional Chaining

Always use optional chaining for nested properties:
value: "{{ response?.data?.items ?? [] }}"
3

Handle Errors

Implement proper error handling in complex operations:
result:
  $exec: |
    try {
      return processData(input);
    } catch (error) {
      return { error: error.message };
    }
4

Type Safety

Use explicit type conversions:
count: "{{ Number(value) }}"
flag: "{{ Boolean(value) }}"

​
Next Steps

Template Functions

Explore built-in utility functions

Custom Dependencies

Learn about adding custom libraries

​
References