Content-addressable template registry with server-side rendering for Typst documents.
Turn your Typst templates into APIs. Publish once, render anywhere.
# Publish a template curl -X POST http://localhost:8080/templates/invoice/publish?tag=latest \ -F "main_typ=@invoice.typ" \ -F "schema=@schema.json" \ -F "metadata={\"name\":\"Invoice\",\"author\":\"you@company.com\"}" # Render with data → PDF curl -X POST http://localhost:8080/render/invoice:latest \ -H "Content-Type: application/json" \ -d '{"company": "Acme Corp", "amount": 1500}' \ --output invoice.pdf- 🏗️ Template as Code - Version your document templates like software
- ⚡ Server-side Rendering - No local Typst installation needed
- 🔒 Content-Addressable - Immutable, deduplicated storage (like Git for documents)
- 📊 Built-in Analytics - Track usage, performance, and errors
- 🐳 Self-hostable - Deploy anywhere with Docker
git clone https://github.com/rkstgr/papermake cd papermake docker-compose up -dThis starts:
- Papermake Server on
localhost:8080 - MinIO (S3-compatible storage) on
localhost:9000, inspectable athttp://localhost:9001 - ClickHouse (analytics) on
localhost:8123
# Copy and update .env with your S3 and Clickhouse credentials cp .env.example .env # Run the server cargo run -r -p papermake-serverTemplates consist of:
main.typ- Your Typst template file- files: Images, fonts, other files (optional)
- Metadata - Name, author, description
// invoice.typ // #data is automatically populated with the input data = Invoice #data.number *Bill To:* #data.customer.name *Amount:* $#data.amountcurl -X POST localhost:8080/templates/invoice/publish?tag=latest \ -F "main_typ=@invoice.typ" \ -F "files[]=@logo.png" \ -F "metadata={\"name\":\"Professional Invoice\",\"author\":\"finance@company.com\"}" # simple publish endpoint curl -X POST http://localhost:3000/api/templates/invoice/publish-simple \ -H 'Content-Type: application/json' \ -d '{ "main_typ": "#set text(font: \"Arial\")\nhello #data.name", "metadata": { "author": "dev@bigbank.com" "name": "Customer Invoice", } }'Returns
{ "data": { "message": "Template 'invoice:latest' published successfully", "manifest_hash": "sha256:8e0e58437230ce87a69a77edec3a24412a2f656bc42456f7f87c61d5de1ad5f9", "reference": "invoice:latest" }, "message": "Template published with reference 'invoice:latest'" }# Render to PDF curl -X POST localhost:8080/render/invoice:latest \ -H "Content-Type: application/json" \ -d '{ "number": "INV-001", "customer": {"name": "Acme Corp"}, "amount": 1500 }' \ --output invoice.pdf# Recent renders curl localhost:8080/renders?limit=10 # Template usage stats curl localhost:8080/analytics/templates # Performance over time curl localhost:8080/analytics/duration?days=30┌─────────────────┐ ┌──────────────────┐ ┌────────────────┐ │ Templates │───▶│ Papermake │───▶│ Registry │ │ (Multipart) │ │ Server │ │ (S3 + CH) │ └─────────────────┘ └──────────────────┘ └────────────────┘ │ ▼ ┌──────────────────┐ │ Typst Engine │ │ (Rendering) │ └──────────────────┘ - Content-Addressable Storage - Templates stored by hash, deduplicated automatically
- Immutable Versions -
invoice:v1.0.0never changes,invoice:latestis mutable - Render Tracking - Every render logged with input/output hashes for full auditability
| Method | Endpoint | Description |
|---|---|---|
POST | /templates/{name}/publish?tag={tag} | Upload template |
GET | /templates | List all templates |
GET | /templates/{name}/tags | List template versions |
POST | /render/{name}:{tag} | Render template to PDF |
GET | /renders?limit=N | Recent render history |
GET | /renders/{id}/pdf | Download rendered PDF |
GET | /analytics/volume?days=N | Render volume over time |
- 📑 Document Generation APIs - Invoices, contracts, reports
- 📧 Email Templates - Marketing campaigns, notifications
- 📋 Form Processing - Applications, certificates, labels
- 📊 Report Automation - Analytics dashboards, financial reports
git clone https://github.com/rkstgr/papermake cd papermake cargo testBuilt with Rust 🦀 • Powered by Typst • Inspired by Docker registry & Git's content addressing
Documentation (coming soon)