ariefsn/html-to-pdf repository overview

⁠HTML to PDF

A mini service to generate PDF from HTML, uses Handlebars for parsing the HTML, Puppeteer to run the headless browser, and NATS for handling queue.

⁠Tools

• Fastify⁠
• Handlebars⁠
• Puppeteer⁠
• NATS⁠
• Docker⁠

⁠How to

1. Go to compose directory cd compose.
2. Copy the .env.example to .env and set the variables.
3. Run docker compose up --build -d.
4. The swagger documentation is on path /docs.
5. The main endpoint is /pdf with method POST, for the payload⁠ described below.

⁠Tag Management

Commands to manage git tags for Docker image releases.

⁠Notes

• This service is using NATS, run NATS server locally or either with docker already in compose/compose.yaml file.
• The client directory is only the example how to interact with the service.

⁠Payload

⁠Webhook Payload

When webhookUrl is provided, the service will POST a JSON body to that URL:

{
  "alias": "my-document",
  "metadata": { "orderId": "123", "userId": "456" },
  "pdf": "<base64-encoded PDF>"
}

⁠Registered Helper