npm install tailprint

import { Tailprint } from 'tailprint';

const tp = new Tailprint({
  apiKey: process.env.TAILPRINT_API_KEY, // Or pass directly
});

// 1. Render Tailwind HTML to vector PDF
const { buffer } = await tp.renderPdf({
  html: `
    <div class="p-12 bg-slate-900 text-white font-sans">
      <h1 class="text-3xl font-bold text-indigo-400">Quarterly Report</h1>
      <p class="text-slate-400 mt-2">Rendered with Tailwind CSS & Playwright.</p>
    </div>
  `,
  format: 'A4',
});

// 2. Merge multiple PDFs
const merged = await tp.mergePdfs({
  pdfs: [bufferA, bufferB],
});

// 3. Stamp Watermark / Page Numbers
const stamped = await tp.stampPdf({
  pdf: buffer,
  text: 'CONFIDENTIAL',
  opacity: 0.2,
  diagonal: true,
});

// 5. Asynchronous Rendering & Webhook Delivery
const job = await tp.renderPdfAsync({
  html: '<h1>Heavy 100-page Annual Report</h1>',
  webhook_url: 'https://my-app.com/api/webhooks/pdf',
});
// Or poll until finished:
const completedJob = await tp.waitForJob(job.job_id);
console.log('PDF Ready at:', completedJob.results[0].download_url);

// 6. Concurrent Batch Rendering with Automatic Merging
const batchJob = await tp.renderBatch({
  items: [
    { html: '<h1>Invoice #101</h1>', filename: 'inv-101.pdf' },
    { html: '<h1>Invoice #102</h1>', filename: 'inv-102.pdf' },
  ],
  merge_output: true,
  merged_filename: 'all-invoices.pdf',
  webhook_url: 'https://my-app.com/api/webhooks/pdf',
});
console.log('Batch Queued:', batchJob.job_id);

pip install tailprint

import os
from tailprint import Tailprint

tp = Tailprint(api_key=os.environ.get("TAILPRINT_API_KEY", "sec_live_..."))

# 1. Render Tailwind HTML to Vector PDF
pdf_bytes = tp.render_pdf(
    html="""
    <div class="p-12 bg-slate-900 text-white font-sans">
        <h1 class="text-3xl font-bold text-indigo-400">Quarterly Invoice</h1>
        <p class="text-slate-400 mt-2">Styled dynamically with Tailwind CSS.</p>
    </div>
    """,
    format="A4",
)
with open("invoice.pdf", "wb") as f:
    f.write(pdf_bytes)

# 2. Asynchronous Render & Webhook
job = tp.render_pdf_async(
    html="<h1>Annual Report</h1>",
    webhook_url="https://my-app.com/api/webhooks",
)
completed = tp.wait_for_job(job["job_id"])
print("PDF ready at:", completed["results"][0]["download_url"])

# 3. Batch Rendering with Merging
batch = tp.render_batch(
    items=[
        {"html": "<h1>Invoice 1</h1>", "filename": "inv-1.pdf"},
        {"html": "<h1>Invoice 2</h1>", "filename": "inv-2.pdf"},
    ],
    merge_output=True,
    merged_filename="combined.pdf",
)

composer require tailprint/tailprint

use Tailprint\Laravel\Facades\Tailprint;

// Render a hosted template directly to a Laravel HTTP download response
return Tailprint::template('invoice-modern', [
    'invoice_number' => 'INV-2026-1042',
    'issue_date'     => '2026-11-13',
    'seller'         => ['name' => 'Tailprint ApS'],
    'buyer'          => ['name' => 'Acme GmbH'],
    'items'          => [['description' => 'Pro Plan', 'quantity' => 1, 'unit_price' => 49]],
])->download('invoice.pdf');

// Or render a Laravel Blade view with Tailwind CSS
return Tailprint::view('pdfs.invoice', ['order' => $order])->stream('invoice.pdf');

go get github.com/coheroseb/tailprint/sdk/go@v1.4.0

client := tailprint.NewClient(os.Getenv("TAILPRINT_API_KEY"))

pdfBytes, err := client.RenderTemplate(ctx, "invoice-modern", map[string]any{
    "invoice_number": "INV-2026-1042",
    "issue_date":     "2026-11-13",
    "seller":         map[string]any{"name": "Tailprint ApS"},
    "buyer":          map[string]any{"name": "Acme GmbH"},
    "items":          []map[string]any{{"description": "Pro Plan", "quantity": 1, "unit_price": 49}},
}, nil)

{
  "mcpServers": {
    "tailprint": {
      "command": "npx",
      "args": ["-y", "tailprint"],
      "env": {
        "TAILPRINT_API_KEY": "YOUR_TAILPRINT_API_KEY"
      }
    }
  }
}

curl -X POST https://tailprint.com/v1/auth/claim-free-key \
  -H "Content-Type: application/json" \
  -d '{"email":"your-email@example.com"}'

curl -X POST https://tailprint.com/v1/render/pdf \
  -H "Authorization: Bearer sec_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<div class=\"p-12 bg-slate-900 text-white font-sans\"><h1 class=\"text-3xl font-bold text-indigo-400\">Invoice #1042</h1><p class=\"text-slate-400 mt-2\">Styled dynamically with Tailwind CSS.</p></div>",
    "format": "A4",
    "landscape": false
  }' \
  --output invoice.pdf

curl -X POST https://tailprint.com/v1/render/einvoice \
  -H "Authorization: Bearer sec_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "invoiceNumber": "INV-2026-0042",
    "currency": "EUR",
    "seller": { "name": "Acme Nordic ApS", "country": "DK", "vatId": "DK12345678" },
    "buyer": { "name": "Global Logistics GmbH", "country": "DE", "vatId": "DE987654321" },
    "lineItems": [{ "name": "Consulting Services", "quantity": 10, "unitPrice": 150.00, "vatRate": 25 }],
    "store": true
  }'

curl -X POST https://tailprint.com/v1/pdf/validate-einvoice \
  -H "Authorization: Bearer sec_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "pdf": "https://example.com/invoice.pdf"
  }'

curl -X POST https://tailprint.com/v1/pdf/merge \
  -H "Authorization: Bearer sec_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "pdfs": ["https://example.com/cover.pdf", "https://example.com/report.pdf"]
  }' \
  --output merged.pdf

curl -X POST https://tailprint.com/v1/pdf/stamp \
  -H "Authorization: Bearer sec_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "pdf": "https://example.com/contract.pdf",
    "text": "CONFIDENTIAL",
    "opacity": 0.2,
    "diagonal": true
  }' \
  --output stamped.pdf

curl -X POST https://tailprint.com/v1/render/batch \
  -H "Authorization: Bearer sec_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "html": "<h1>Invoice #101</h1>", "filename": "inv-101.pdf" },
      { "html": "<h1>Invoice #102</h1>", "filename": "inv-102.pdf" }
    ],
    "merge_output": true,
    "merged_filename": "all-invoices.pdf",
    "webhook_url": "https://my-app.com/api/webhooks/pdf"
  }'

# Browse templates (no API key required)
curl https://tailprint.com/v1/templates
curl https://tailprint.com/v1/templates/invoice-modern   # example_data + example_request

curl -X POST https://tailprint.com/v1/render/pdf \
  -H "Authorization: Bearer sec_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "invoice-modern",
    "data": {
      "invoice_number": "INV-1042",
      "issue_date": "2026-11-13",
      "currency": "EUR",
      "seller": { "name": "Tailprint ApS" },
      "buyer": { "name": "Cohero Technologies" },
      "items": [{ "description": "API Subscription", "quantity": 1, "unit_price": 49 }],
      "tax_rate": 25
    }
  }' --output invoice.pdf

curl https://tailprint.com/v1/jobs/job_batch_0123456789abcdef

# Clone the repository
git clone https://github.com/coheroseb/tailprint.git
cd tailprint

# Install dependencies
npm install
npx playwright install chromium

# Copy environment variables
cp .env.example .env

# Run development server with hot-reload
npm run dev

# Run unit & integration test suite
npm test

docker compose up -d --build