# @pagopa/io-app-email-templates

> Common html template for email

Latest version **0.8.2** (published 2026-09-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install @pagopa/io-app-email-templates
pnpm add @pagopa/io-app-email-templates
yarn add @pagopa/io-app-email-templates
bun add @pagopa/io-app-email-templates
```

## Health

**Score 65/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; no types; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.8.2 |
| Published | 2026-09-24 |
| First published | 2024-04-16 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 5 |
| Unpacked size | 445 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 1 |
| Author | https://www.pagopa.gov.it |
| Maintainers | pp-ps, giuseppe-nuccio-crea, diego.lagosmorales |

## Links

- npm: https://www.npmjs.com/package/@pagopa/io-app-email-templates
- Repository: https://github.com/pagopa/io-app-email-templates
- Homepage: https://github.com/pagopa/io-app-email-templates#readme
- Issues: https://github.com/pagopa/io-app-email-templates/issues
- npm.io page: https://npm.io/package/@pagopa/io-app-email-templates

## Dependencies (5)

- [fp-ts](https://npm.io/package/fp-ts.md) ^2.16.5
- [io-ts](https://npm.io/package/io-ts.md) ^2.2.21
- [prettier](https://npm.io/package/prettier.md) ^3.8.3
- [moment-timezone](https://npm.io/package/moment-timezone.md) ^0.6.0
- [@pagopa/ts-commons](https://npm.io/package/@pagopa/ts-commons.md) ^14.0.0

## Recent versions

- 0.8.2 (latest) — 2026-09-24
- 0.8.1 — 2026-04-13
- 0.8.0 — 2026-01-19
- 0.7.3 — 2025-11-26
- 0.7.0 — 2025-11-19
- 0.6.2 — 2025-11-17
- 0.6.1 — 2025-11-14
- 0.6.0 — 2025-11-10
- 0.5.1 — 2025-04-24
- 0.5.0 — 2025-03-27
- 0.4.0 — 2025-03-05
- 0.3.0 — 2025-02-20
- 0.2.4 — 2025-02-10
- 0.2.3 — 2025-01-09
- 0.2.2 — 2024-12-17
- … 3 more at https://npm.io/package/@pagopa/io-app-email-templates/versions

## README

# io-app-email-templates

This repo contains the mail template(s) sent on behalf of IO App and its services. Templates are created using [MJML](https://mjml.io/) markup language along with typescript files.

## How to apply changes

To edit them, you can choose among these following options:

- [Online editor](https://mjml.io/try-it-live)
- [Local installation](https://mjml.io/download)
- [Visual Studio Code plugin](https://marketplace.visualstudio.com/items?itemName=mjmlio.vscode-mjml)

To generate the HTML output you need to install the following CLI tool:

1. [MJML](https://www.npmjs.com/package/mjml) package:

```shell
npm install -g mjml && mjml <MJML_INPUT_FILE> -o <OUTPUT_FILE>
```

## Add a new template

Steps:

1. Create a directory on the root of the project with a name of your choice.
2. Put an `apply` method in a typescript file named `applier.template.ts` inside your template directory.
3. Put a generation step inside `package.json`(follow the other scripts as example). This will generate an `index.ts` file with the template inside.
   Make sure to put `{{TEMPLATE}}` in the method that is going to be replaced with the HTML generated from the mjml file.
4. Generate a snapshot test to make sure the content doesn't change unexpectedly

## Release

In order to release a new version:

1. Run [the release action](https://github.com/pagopa/io-app-email-templates/actions/workflows/bump-release.yaml)
2. A new PR will be created, review, approve and merge it
3. The [publish action](https://github.com/pagopa/io-app-email-templates/actions/workflows/publish-to-package-registry.yaml) will start and release both a tag and a new package version in the npm package registry

You can check here if the new version has been published once the publish action
is completed.

## Compatibility

Templates are compatible with the following clients:

- Apple Mail 13+ (dark mode included)
- Gmail Web app
- OL Office 365 (dark mode included, partially supported on Windows)
- Outlook 2013, 2016, 2019, 2021 (dark mode included, partially supported on Windows)
- Windows 10 Mail (dark mode partially supported)
- Windows 11 Mail
- Gmail App (Android 6+, dark mode partially supported)
- Gmail App (iOS 13.1+, dark mode partially supported)
- iPad (iOS 13.1+)
- iPhone (iOS 13.1+)
- AOL Mail
- Outlook.com Mail (dark mode partially supported)
- Yahoo! Mail

### Related mail templates

- [Area Riservata (former SelfCare)](https://github.com/pagopa/selfcare-email-templates)
- [Piattaforma Notifiche](https://github.com/pagopa/pn-email-templates)
- [pagoPA](https://github.com/pagopa/pagopa-email-templates)

---
_Source: https://npm.io/package/@pagopa/io-app-email-templates · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._