README.md

🧾 pagopa-template-receipt-pdf

This repo contains the pdf receipt templates used by pagoPA

• 🧾 pagopa-template-receipt-pdf
  • Dependecies
  • How to apply changes
  • How to install and run pdf generator
  • Compatibility
  • Related mail templates

Dependecies

• Node JS (👀 .node-version file), optional see nvm
• yarn
• Handlebars CLI to render handlebars templates
• Puppeteer to generates a PDF of the page with the print CSS media type

How to apply changes

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

• Online editor
• Local installation
• Visual Studio Code plugin

To generate the HTML output you need to install dependecies typing

How to install and run pdf generator

Under receipt/success/pdf folder, on terminal typing :

yarn install

if all right you'll see something like that

success Saved lockfile.
✨  Done in 21.71s.

then typing :

yarn generate-complete

or

yarn generate-partial

if all right you'll see something like that

Wrote /pagopa-template-receipt-pdf/receipt/success/pdf/template.html from /pagopa-template-receipt-pdf/receipt/success/pdf/template.hbs
✨  Done in 5.62s.

and now, after typing ls -lrt command u'll see a PDF file naming pagopa-receipt-<UUID>.pdf

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

• IO App
• Area Riservata (former SelfCare)
• Piattaforma Notifiche
• Ecommerce Notifications Service (pagoPA doc)