# og.ghur.my — Zar OG image generator

Renders 1200×630 PNG Open Graph images in the Zar design language
(pure black/white, zero radius, hairlines, OpenAI Sans, aurora brand colour).

## Render

GET  https://og.ghur.my/og?template=glow&title=Hello+world   → image/png
POST https://og.ghur.my/og  (Content-Type: application/json, same fields) → image/png

The GET URL is stable and cacheable: put it straight into
<meta property="og:image" content="https://og.ghur.my/og?..."> (URL-encode values).
Use POST when the icon/image is a data: URI (too long for a URL).

## Fields

template  glow | hero | split | mono          (default glow)
theme     dark | light                        (default dark)
title     string, auto-fits, max 200 chars    (required in practice)
subtitle  string, alias: description
eyebrow   short mono kicker, uppercased, alias: label
footer    mono footer text, e.g. "ghur.my/blog"
icon      "zar" (default) | https URL | data: URI   (png, jpeg, webp, gif, svg)
tint      auto | aurora | none  — aurora fills a custom icon's silhouette with the brand gradient
image     https URL | data: URI  — the right-hand picture in the split template
tags      comma-separated chips (mono template), max 5 shown
cta       button label (mono template)

## Templates

glow   centred icon + title, aurora rising from the bottom. Best default.
hero   big fluid-aurora icon left, display title right, hairline frame. Launches, landing pages.
split  text left, full-bleed image right. Blog posts, case studies, screenshots.
mono   technical sheet: grid, mono header, tag chips, cloud CTA. Changelogs, docs, releases.

## Examples

https://og.ghur.my/og?template=glow&eyebrow=Launch&title=Zar+records+your+UI&subtitle=Validate+every+change+in+a+real+browser&footer=zar.dev
https://og.ghur.my/og?template=mono&eyebrow=Changelog&title=v0.4+—+real+mouse+input&tags=rust,xdotool,docker&cta=Read+more&footer=og.ghur.my
curl -s -X POST https://og.ghur.my/og -H 'content-type: application/json' \
  -d '{"template":"split","title":"Case study","image":"https://picsum.photos/800"}' -o og.png

## Notes

- Failed icon/image fetches still render (without it); the reason is in the `x-og-warning` response header.
- Machine-readable schema: GET https://og.ghur.my/api/templates
- Emoji are not supported in text (no emoji font).