{"id":37050123,"url":"https://github.com/tolgaand/umay-render","last_synced_at":"2026-01-14T05:49:05.587Z","repository":{"id":280354888,"uuid":"941727117","full_name":"tolgaand/umay-render","owner":"tolgaand","description":"Free, high-performance HTML to PDF and HTML to Image conversion service with easy-to-use SDK","archived":false,"fork":false,"pushed_at":"2025-07-19T20:37:25.000Z","size":10788,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-09T10:27:13.475Z","etag":null,"topics":["html-to-image","html-to-pdf","image-generator","pdf-generator"],"latest_commit_sha":null,"homepage":"https://umayrender.com","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tolgaand.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-03T00:03:30.000Z","updated_at":"2025-07-19T20:37:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"b1568609-d1a9-4d6d-9b37-c67e165e5070","html_url":"https://github.com/tolgaand/umay-render","commit_stats":null,"previous_names":["tolgaand/umay-render"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tolgaand/umay-render","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tolgaand%2Fumay-render","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tolgaand%2Fumay-render/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tolgaand%2Fumay-render/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tolgaand%2Fumay-render/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tolgaand","download_url":"https://codeload.github.com/tolgaand/umay-render/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tolgaand%2Fumay-render/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28411506,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T05:26:33.345Z","status":"ssl_error","status_checked_at":"2026-01-14T05:21:57.251Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["html-to-image","html-to-pdf","image-generator","pdf-generator"],"created_at":"2026-01-14T05:49:05.012Z","updated_at":"2026-01-14T05:49:05.582Z","avatar_url":"https://github.com/tolgaand.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Umay Render\n\n[![npm version](https://img.shields.io/npm/v/umay-render.svg)](https://www.npmjs.com/package/umay-render)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\n**Umay Render** is a free, high-performance HTML to PDF and HTML to Image conversion service with an easy-to-use SDK. Unlike other expensive conversion services, Umay Render provides a completely free solution with enterprise-grade performance.\n\n## Features\n\n- ✅ **Free and Open Source** - No hidden costs or usage limits\n- ✅ **High Performance** - Optimized for speed and reliability\n- ✅ **Multiple Output Formats** - Generate PDFs and images (PNG)\n- ✅ **Easy to Use SDK** - Simple API for both frontend and backend\n- ✅ **Customizable Options** - Control page size, margins, quality, and more\n- ✅ **Cross-Platform** - Works on all major platforms\n\n## Installation\n\n```bash\nnpm install umay-render\n# or\nyarn add umay-render\n# or\npnpm add umay-render\n```\n\n## Quick Start\n\n### Generate PDF from HTML\n\n```javascript\n// Client-side (Browser)\nimport { UmaySDK } from 'umay-render';\n\n// Initialize the SDK\nconst client = new UmaySDK(); \n// Or with custom API URL (optional)\n// const client = new UmaySDK({ \n//   API_URL: 'https://your-custom-api-url.com', // Optional: A default API URL is provided\n//   TIMEOUT: 60000 // Optional: Default is 30000 (30 seconds)\n// });\n\n// Generate PDF from HTML\nconst pdfBuffer = await client.toPDF('\u003chtml\u003e\u003cbody\u003e\u003ch1\u003eHello World\u003c/h1\u003e\u003c/body\u003e\u003c/html\u003e', {\n  format: 'A4',\n  landscape: false,\n  printBackground: true\n});\n\n// Download the PDF\nclient.downloadBlob(pdfBuffer, 'document.pdf', 'application/pdf');\n\n\n// Server-side (Node.js)\nimport { UmaySDK } from 'umay-render';\nimport fs from 'fs';\n\n// Initialize the SDK\nconst client = new UmaySDK();\n// Or with custom API URL (optional)\n// const client = new UmaySDK({ \n//   API_URL: 'https://your-custom-api-url.com', // Optional: A default API URL is provided\n//   TIMEOUT: 60000 // Optional: Default is 30000 (30 seconds)\n// });\n\n// Generate PDF from HTML\nconst pdfBuffer = await client.toPDF('\u003chtml\u003e\u003cbody\u003e\u003ch1\u003eHello World\u003c/h1\u003e\u003c/body\u003e\u003c/html\u003e', {\n  format: 'A4',\n  landscape: false,\n  printBackground: true\n});\n\n// Save the PDF to file\nfs.writeFileSync('document.pdf', pdfBuffer);\n```\n\n### Generate Image from HTML\n\n```javascript\n// Client-side (Browser)\nimport { UmaySDK } from 'umay-render';\n\n// Initialize the SDK\nconst client = new UmaySDK();\n// Or with custom API URL (optional)\n// const client = new UmaySDK({ \n//   API_URL: 'https://your-custom-api-url.com', // Optional: A default API URL is provided\n//   TIMEOUT: 60000 // Optional: Default is 30000 (30 seconds)\n// });\n\n// Generate JPEG image from HTML\nconst imageBuffer = await client.toImage('\u003chtml\u003e\u003cbody\u003e\u003ch1\u003eHello World\u003c/h1\u003e\u003c/body\u003e\u003c/html\u003e', {\n  type: 'jpeg',\n  quality: 90,\n  fullPage: true,\n  viewport: {\n    width: 1920,\n    height: 1080,\n    deviceScaleFactor: 2\n  }\n});\n\n// Display or download the image\nclient.downloadBlob(imageBuffer, 'image.jpg', 'image/jpeg');\n```\n\n## Supported SDKs\n\n| Language   | Status            | Package Name      |\n|------------|-------------------|-------------------|\n| TypeScript | ✅ Available      | umay-render       |\n| JavaScript | ✅ Available      | umay-render       |\n| Python     | 🔜 Coming Soon    | umay-render-py    |\n| Go         | 🔜 Coming Soon    | umay-render-go    |\n| Rust       | 🔜 Coming Soon    | umay-render-rs    |\n| C#         | 🔜 Coming Soon    | UmayRender.NET    |\n| Java       | 🔜 Coming Soon    | umay-render-java  |\n| PHP        | 🔜 Coming Soon    | umay-render-php   |\n| Ruby       | 🔜 Coming Soon    | umay-render-ruby  |\n\n## Why Choose Umay Render?\n\n### Cost-Effective Solution\n\nCommercial HTML-to-PDF services can cost hundreds or thousands of dollars per month based on usage. Umay Render provides the same functionality completely free, saving you significant costs.\n\n### Simple Integration\n\nWhether you're working with frontend applications or backend services, Umay Render's SDK makes integration quick and painless. The same consistent API works across environments.\n\n### Developer-Friendly\n\nOur TypeScript SDK provides type safety and excellent IDE integration. Clear documentation and examples make it easy to get started.\n\n### Versatile Output Options\n\nCustomize your PDFs and images with flexible options for page size, orientation, margins, quality, and more.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Examples\n\n### Template Showcase\n\n| Template | HTML Source | PDF Output |\n|----------|------------|------------|\n| Invoice | [View HTML](./packages/umay-cli/examples/input/examples-1-invoice.html) | [View PDF](./packages/umay-cli/examples/output/examples-1-invoice.pdf) |\n| Resume | [View HTML](./packages/umay-cli/examples/input/examples-2-resume.html) | [View PDF](./packages/umay-cli/examples/output/examples-2-resume.pdf) |\n| Business Report | [View HTML](./packages/umay-cli/examples/input/examples-3-report.html) | [View PDF](./packages/umay-cli/examples/output/examples-3-report.pdf) |\n| Certificate | [View HTML](./packages/umay-cli/examples/input/examples-4-certificate.html) | [View PDF](./packages/umay-cli/examples/output/examples-4-certificate.pdf) |\n| Restaurant Menu | [View HTML](./packages/umay-cli/examples/input/examples-5-menu.html) | [View PDF](./packages/umay-cli/examples/output/examples-5-menu.pdf) |\n\nThese example templates showcase different HTML/CSS techniques optimized for PDF rendering.\n\n### Invoice Template\n\nConvert HTML invoices to PDF or image formats with perfect formatting.\n\n\u003cdetails\u003e\n  \u003csummary\u003eView Invoice HTML Source\u003c/summary\u003e\n\n```html\n\u003c!DOCTYPE html\u003e\n\u003chtml lang=\"en\"\u003e\n  \u003chead\u003e\n    \u003cmeta charset=\"UTF-8\" /\u003e\n    \u003cmeta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" /\u003e\n    \u003ctitle\u003eInvoice\u003c/title\u003e\n    \u003cstyle\u003e\n      @page {\n        size: A4;\n        margin: 0;\n      }\n\n      :root {\n        --primary-color: #2979ff;\n        --secondary-color: #f5f5f5;\n        --text-color: #333333;\n        --border-color: #dddddd;\n      }\n\n      body {\n        font-family: \"Segoe UI\", Tahoma, Geneva, Verdana, sans-serif;\n        margin: 0;\n        padding: 0;\n        color: var(--text-color);\n        background-color: #fff;\n        font-size: 12px;\n        line-height: 1.4;\n        -webkit-print-color-adjust: exact;\n        print-color-adjust: exact;\n      }\n\n      .invoice-container {\n        width: 210mm;\n        min-height: 297mm;\n        margin: 0 auto;\n        padding: 15px;\n        box-sizing: border-box;\n      }\n\n      /* Additional styles omitted for brevity */\n    \u003c/style\u003e\n  \u003c/head\u003e\n  \u003cbody\u003e\n    \u003cdiv class=\"invoice-container\"\u003e\n      \u003c!-- Invoice content omitted for brevity --\u003e\n      \u003c!-- See complete example in packages/umay-cli/examples/input/invoice.html --\u003e\n    \u003c/div\u003e\n  \u003c/body\u003e\n\u003c/html\u003e\n```\n\u003c/details\u003e\n\n#### Output Examples\n\n**PDF Output:**\n\n[View Example PDF](./packages/umay-cli/examples/output/invoice.pdf)\n\n**Image Output:**\n\n![Invoice Image Example](./packages/umay-cli/examples/output/invoice.jpg)\n\n#### CLI Command Used\n\n```bash\n# Generate PDF\numay render ./examples/input/invoice.html -t pdf -o ./examples/output/invoice.pdf\n\n# Generate PNG Image\numay render ./examples/input/invoice.html -t image -o ./examples/output/invoice.png -w 900 -h 1300 -s 1 --full-page false\n```\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Keywords\n\nHTML to PDF, HTML to Image, PDF generation, Image generation, Web to PDF, Screenshot service, Puppeteer, PDF converter, Free PDF generator, Open source PDF, TypeScript SDK ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftolgaand%2Fumay-render","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftolgaand%2Fumay-render","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftolgaand%2Fumay-render/lists"}