# Rynko

> Rynko is a document generation platform that creates professional PDF and Excel documents from JSON templates with dynamic data in a single API call. Design templates in a visual editor, then generate documents programmatically via API.

**Core Value**: Replace complex PDF generation setups (Puppeteer, wkhtmltopdf, DocRaptor) with one simple API. Design once, generate unlimited documents.

## Key API Endpoint

`POST https://api.rynko.dev/api/v1/documents/generate` - Generate PDF or Excel from template

## Rendering Engine

Rynko uses a **native rendering engine** (not HTML-to-PDF conversion):
- **Sub-second generation**: 200-500ms typical (vs 3-8s for HTML-to-PDF)
- **Yoga Layout Engine**: Facebook's Flexbox engine (same as React Native)
- **28 Component Types**: Text, tables, charts, QR codes, barcodes, form fields
- **8 Chart Types**: Bar, line, pie, doughnut, area, radar, polar area, scatter
- **10 Barcode Formats**: Code128, Code39, EAN-13/8, UPC-A/E, ITF-14, PDF417, DataMatrix, QR
- **9 PDF Form Fields**: Text, textarea, checkbox, radio, dropdown, signature, date, button, image
- **TextRuns**: JSON-based rich text (no HTML parsing, zero XSS surface)
- **Hybrid Logic**: JavaScript expressions + Excel formulas in same template

## Pricing

### Subscription Tiers

| Tier | Documents/Month | Team Members | Price |
|------|-----------------|--------------|-------|
| Free | 50 | 1 | $0 |
| Starter | 500 | 3 | $19/mo |
| Growth | 2,500 | 10 | $49/mo |
| Scale | 10,000 | Unlimited | $99/mo |

### Credit Packs (One-Time Purchase)

| Pack | Documents | Price | Per Doc |
|------|-----------|-------|---------|
| Small | 500 | $15 | $0.03 |
| Large | 2,500 | $50 | $0.02 |

**Key Features by Tier**:
- **Free**: Watermarked documents, 1 workspace
- **Starter**: No watermark, webhooks, 2 workspaces
- **Growth**: PDF form fields, Google Sheets add-on, batch generation, 5 workspaces
- **Scale**: Priority support, SLA, unlimited workspaces

## Quick Example

```javascript
const response = await fetch('https://api.rynko.dev/api/v1/documents/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    templateId: 'invoice-template',
    format: 'pdf',
    variables: {
      invoiceNumber: 'INV-2026-001',
      customerName: 'Acme Corp',
      items: [
        { description: 'Consulting', quantity: 10, price: 150.00 }
      ],
      total: 1500.00
    }
  })
});

const { downloadUrl, statusUrl } = await response.json();
```

## Core Documentation

- [Getting Started](/getting-started): Create account, API keys, first document
- [Generating Documents](/developer-guide/generating-documents): Complete API guide
- [Template Schema](/developer-guide/template-schema): JSON schema for templates

## Integrations

### Official SDKs
- **Node.js**: `@rynko/sdk` — npm: https://www.npmjs.com/package/@rynko/sdk | GitHub: https://github.com/rynko-dev/sdk-node
- **Python**: `rynko` — PyPI: https://pypi.org/project/rynko/ | GitHub: https://github.com/rynko-dev/sdk-python
- **Java**: `dev.rynko:sdk` — Maven: https://central.sonatype.com/artifact/dev.rynko/sdk | GitHub: https://github.com/rynko-dev/sdk-java

### No-Code Platforms
- Zapier, Make.com, n8n

### Other
- Google Sheets Add-on: Mail merge and batch document generation
- Webhooks: Real-time document.generated, document.failed events
- MCP Server: AI agent integration for Claude, GPT, etc.

## Output Formats

| Feature | PDF | Excel |
|---------|-----|-------|
| Charts | Yes | Yes (as images for consistency) |
| Tables | Yes | Yes (with Excel formulas) |
| QR/Barcodes | Yes | Yes |
| Form Fields | Yes (9 types) | No |
| Flexbox Layout | Yes (Yoga) | No |
| Multi-page/sheet | Yes | Yes |
| Custom Fonts | Yes | No |

## Security

- TLS 1.3 encryption
- Signed download URLs (time-limited)
- GDPR compliant
- SOC 2 Type II (in progress)

## Links

- Website: https://rynko.dev
- Docs: https://docs.rynko.dev
- API Reference: https://docs.rynko.dev/api-reference
- Status: https://status.rynko.dev
- Node.js SDK: https://www.npmjs.com/package/@rynko/sdk
- Python SDK: https://pypi.org/project/rynko/
- Java SDK: https://central.sonatype.com/artifact/dev.rynko/sdk
- SDK Reference: https://docs.rynko.dev/llms-sdk-reference.txt