Changelog

All notable changes to OG Engine are documented here. OG Engine follows Semantic Versioning.

v0.1.0 — 2026-04-03

Initial public release. Everything you need to replace Puppeteer for image generation.

POST /render — Generate a single image from a JSON payload. Returns binary PNG (all plans) or WebP (Starter+). Typical render time: ~22ms (benchmarked).
POST /validate — Check whether title and description text fits a layout without generating an image. Free, unlimited, no authentication required. Use it in CI, forms, or content pipelines.
POST /render/batch — Render up to 100 images in a single API call. Returns a ZIP archive. Available on Pro and Scale plans — ideal for SaaS platforms generating images during deployment.
GET /health — Returns service status, API version, and lists of available fonts, formats, and templates.
POST /auth/register — Get an API key with just your email. No credit card. Instant access.
GET /usage — Check your quota at any time.

Four production-ready templates — every template works on every plan:

default — Accent bar, grid background pattern, tag pill badge, and author line. Supports left, center, and bottom layouts.
social-card — Large centered title with minimal decoration. Designed for Twitter and Instagram.
blog-hero — Background image compositing with dark overlay. Text anchored to the lower canvas. Perfect for content-heavy sites.
email-banner — Horizontal CTA-style layout for email headers and newsletter banners. Use with batch rendering for personalized campaigns.

Five canonical format presets covering every major platform:

Eight pre-loaded font families — including CJK and Arabic support:

Outfit — Modern geometric sans-serif (default). Best for tech and SaaS.
Inter — Neutral, screen-optimized. Best for data-heavy content.
Playfair Display — Elegant serif. Best for editorial and luxury brands.
Sora — Rounded, friendly. Best for consumer products.
Space Grotesk — Techy sans-serif. Best for developer tools.
JetBrains Mono — Monospaced. Best for code-related content.
Noto Sans JP — Full Japanese CJK support. For products serving Japanese users.
Noto Sans AR — Full Arabic support with bidirectional text. For products serving Arabic users.

@atypical-consulting/og-engine-sdk on npm — full TypeScript types, auto-retry, framework examples:

Integration examples included for Next.js, Astro, Express, and Cloudflare Workers.

Scale, polish, and growth features.

PDF output — output.format: "pdf" generates a single-page PDF with the rendered image embedded. Zero dependencies.
AI text fitting — style.autoFit: true on /render and autoFit: true on /validate. Binary search finds the largest font size that fits within line limits.
Custom template builder — JSON DSL with 6 layer types (fill, gradient, rect, text, image, line). Variable interpolation with {{title}}, {{description}}, {{author}}, {{tag}}, {{accent}}. Scale plan only.
Webhook triggers — Register callback URLs with saved render configs. POST /triggers/:id/fire re-renders and POSTs the image to your URL. Supports content overrides.
Image cache — In-memory LRU cache for rendered images. Cache hits return instantly with X-Cache: hit header.

SQLite database for API keys, usage tracking, custom templates, and webhooks
API key authentication with plan-based feature gating (402 Payment Required)
Usage metering with per-endpoint and per-format breakdown
Stripe webhook handler for checkout, subscription updates, and billing cycle resets
Rate limiting with configurable window and max via environment variables
Biome linting and formatting
GitHub Actions CI — lint, type-check, test, Docker build on every PR
Lefthook pre-commit hooks for lint and type-check

Version	Focus	Highlights
v0.3.0	Edge & Fonts	Cloudflare Workers deployment, additional font families, SVG output
v1.0.0	Stability	Stable API contract, SLA guarantees, Python/Go/Ruby SDKs

Subscribe to status.og-engine.com for release notifications.