3renderers.dev

A powerful, scalable PDF generation API supporting three open-source rendering engines: WeasyPrint, Paged.js, and Vivliostyle. Built with Node.js, TypeScript, and Docker.

🚀 Quick Start

1. Clone and Configure

# Clone repository
cd /opt
sudo git clone https://github.com/CSS-Paged-Media/3renderers.git
cd 3renderers

# Create production env file
cp .env.example .env.production
nano .env.production

Production .env.production:

NODE_ENV=production

# Database (CHANGE THESE!)
POSTGRES_HOST=postgres
POSTGRES_PORT=5432
POSTGRES_DB=pdfgen
POSTGRES_USER=pdfuser
POSTGRES_PASSWORD=CHANGE_THIS_TO_SECURE_PASSWORD_XYZ123

# Redis
REDIS_HOST=redis
REDIS_PORT=6379

# Worker
WORKER_CONCURRENCY=5

# API
API_PORT=3000

2. Start Production Services

# Build and start
docker-compose -f docker-compose.yml up --build -d

# Check status
docker-compose -f docker-compose.yml ps

# View logs
docker-compose -f docker-compose.yml logs -f

3. Rebuild cron (optional)

chmod +x /opt/3renderers/scripts/update-docker.sh

# Run daily at 2 AM
0 2 * * * /opt/3renderers/scripts/update-docker.sh

4. Test the API

# Simple PDF generation
curl -X POST http://localhost/api/render \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<h1>Hello World</h1>",
    "options": {
      "renderer": "weasyprint",
      "sync": "true"
    }
  }' \
  --output test.pdf

📚 API Documentation

https://www.postman.com/three-renderers/pdf-api/overview