lettr-kit

CLI tool for managing Lettr email templates locally.

Installation

npm install -g lettr-kit

Or run directly with npx:

npx lettr-kit

Setup

Initialize a config file in your project:

lettr-kit init

This creates a lettr.json file:

{
  "apiKey": "$LETTR_API_KEY",
  "outputDir": "./emails"
}

• apiKey — Your API key directly, or $ENV_VAR to reference an environment variable.
• outputDir — Directory where templates will be saved.

API Key Resolution

The API key is resolved in this order:

1. --api-key flag
2. apiKey in lettr.json (supports $ENV_VAR syntax)
3. LETTR_API_KEY environment variable

Commands

lettr-kit init

Interactively creates a lettr.json config file in the current directory.

lettr-kit list

Lists all templates from the Lettr API.

lettr-kit list
lettr-kit list --api-key lttr_abc123

lettr-kit pull

Pulls all templates and saves them as {slug}.html files in the configured output directory.

lettr-kit pull
lettr-kit pull --api-key lttr_abc123

License

MIT