Developer API

Generate Open Graph images programmatically

Every template in the editor is available through a simple API. Request an image with one HTTP GET and get a PNG back, or render entirely in the browser with the SDK — fully customizable: any template, preset, slot, background, typography, logo, and platform size.

No signup, no API keyStateless & private — nothing stored73 templates · 5 sizes

Quick start

The fastest path — pass a template id and any content as query params:

# Returns image/png (2× the platform size)
curl -L "https://freeogimage.com/api/og?template=saas-dark&preset=ember&title=Ship+faster" -o card.png

Use it directly as your share image in HTML:

<meta property="og:image" content="https://freeogimage.com/api/og?template=gradient-mesh&title=Hello+world" />
<meta name="twitter:card" content="summary_large_image" />

For full control (backgrounds, typography, logo, every slot), encode a JSON config — see the config schema and the SDK.

Prefer to design visually first? Build your card in the editor, then hit Get API to copy the exact GET URL, POST curl, and SDK call for your current design.

HTTP endpoint

GET https://freeogimage.com/api/og — renders a config and responds with image/png. Two ways to supply the config:

Param	Type	Notes
`config`	base64url(JSON)	A full OgImageConfig (see below). Takes precedence over the convenience params.
`template`	string	Template id (required if no config). See the reference below.
`preset`	string	Preset id; defaults to the template's default preset.
`platform`	string	Output size id (og, twitter, linkedin, facebook, square). Default og.
`title`	string	Convenience: fills the template's preview title slot (often `title`). An explicit slot.<id> wins.
`description`	string	Convenience: fills the template's preview description slot (often `subtitle`, not literally `description`).
`slot.<id>`	string	Set any slot by its exact id (see the template reference), e.g. slot.badge=New.

Response: a PNG at 2× the platform size (e.g. og 1200×630 → 2400×1260). Cache-Control and Access-Control-Allow-Origin: * are set so it works in <img>, meta tags, and cross-origin fetches.
Errors: an invalid config returns 400 with a plain-text reason (e.g. unknown template/preset/platform).
Limits: rate-limited per IP (the limit applies to every request, including cache hits) and cached by config hash so repeats skip re-rendering. Be reasonable — it runs on a small box.
Images: for SSRF safety the service does not fetch external image URLs. Pass images for image/logo/background slots as data: URLs (use a POST JSON body for large ones), or use the in-browser SDK (which can load https: images in the user's own browser).
Privacy: the service renders your config and discards it. No configs, URLs, or images are stored or logged. Nothing leaves the render.

Config schema

One shape powers the endpoint, the SDK, and the ?config= deep link. It layers exactly like the editor: template defaults → preset → your slots/globals.

interface OgImageConfig {
  template: string;                 // required — a template id (see reference below)
  preset?: string;                  // a preset id; default = the template's default preset
  platform?: "og" | "twitter" | "linkedin" | "facebook" | "square";  // default "og"
  slots?: { [slotId: string]: string };   // per-template content (see each template's slots)
  globals?: DeepPartial<GlobalOptions>;   // styling overrides — see "Global options"
}

Unknown slot ids and unknown global keys are ignored (forward-compatible). A missing or unknown template, preset, or platform is a 400.

Global options

globals is a deep-partial of the editor's global controls. Only the keys a template supports (listed per template below) take effect.

interface GlobalOptions {
  background:
    | { kind: "solid"; color: string }
    | { kind: "gradient"; gradient: { type: "linear"|"radial"|"conic"; angle?: number;
                                      stops: { color: string; pos: number }[] } }
    | { kind: "mesh"; stops: { color: string; pos: number }[]; seed?: number }
    | { kind: "grid"; base: string; grid: { kind: "dots"|"lines"|"iso"|"blueprint";
                                            size: number; color: string; opacity: number } }
    | { kind: "image"; src: string; fit: "cover"|"contain"; overlay?: string };  // src: data: URL (https: only via the SDK)
  typography: { fontFamily: "inter"|"grotesk"|"mono"|"serif"; weightTitle: number;
                weightBody: number; titleSize?: number; letterSpacing?: number;
                textColor: string; align: "left"|"center"|"right" };
  logo: { src?: string; position: "top-left"|"top-right"|"bottom-left"|"bottom-right"|"none";
          size: number; rounded?: boolean };          // src: data: URL (https: only via the SDK)
  noise: { enabled: boolean; opacity: number };       // 0..1
  vignette: { enabled: boolean; strength: number };   // 0..1
  padding: number;                                    // safe-area inset (px)
  watermark: boolean;                                 // small "made with freeogimage.com"
}

Platform sizes

id	Label	Logical	Exported (2×)
`og`	Open Graph	1200×630	2400×1260
`twitter`	X / Twitter	1600×900	3200×1800
`linkedin`	LinkedIn	1200×627	2400×1254
`facebook`	Facebook	1200×630	2400×1260
`square`	Square	1080×1080	2160×2160

Fonts

Self-hosted fonts only. Use one of these keys for globals.typography.fontFamily:

inter — Intergrotesk — Space Groteskmono — JetBrains Monoserif — Source Serif

In-browser SDK

Prefer to generate on the client with no network call at all? The same render path the editor uses is exposed as renderOgImage. Nothing is uploaded — the PNG is produced entirely in the browser.

import { renderOgImage } from "@/lib/og/render";

const dataUrl = await renderOgImage({
  template: "saas-dark",
  preset: "ember",
  slots: { title: "Ship faster", subtitle: "One fast workspace for your team." },
});
// -> "data:image/png;base64,..."  (also: { format: "blob" } for a Blob)

Build a stable image URL without rendering yourself with ogImageUrl(config) (from @/lib/og/config).

Worked examples

Encoded full-config URLs (copy & open):

Dark SaaS card

https://freeogimage.com/api/og?config=eyJ0ZW1wbGF0ZSI6InNhYXMtZGFyayIsInByZXNldCI6ImVtYmVyIiwic2xvdHMiOnsidGl0bGUiOiJTaGlwIGZhc3RlciB3aXRoIFRhc2tsYW5lIiwic3VidGl0bGUiOiJPbmUgZmFzdCB3b3Jrc3BhY2UgZm9yIHlvdXIgd2hvbGUgcHJvZHVjdCB0ZWFtLiJ9fQ

Custom gradient + centered type

https://freeogimage.com/api/og?config=eyJ0ZW1wbGF0ZSI6ImdyYWRpZW50LW1lc2giLCJwbGF0Zm9ybSI6Im9nIiwic2xvdHMiOnsiYmFkZ2UiOiJOb3cgaW4gYmV0YSIsInRpdGxlIjoiSW50cm9kdWNpbmcgTm9ydGh3aW5kIEFuYWx5dGljcyJ9LCJnbG9iYWxzIjp7ImJhY2tncm91bmQiOnsia2luZCI6ImdyYWRpZW50IiwiZ3JhZGllbnQiOnsidHlwZSI6ImxpbmVhciIsImFuZ2xlIjoxMjAsInN0b3BzIjpbeyJjb2xvciI6IiMwZWE1ZTkiLCJwb3MiOjB9LHsiY29sb3IiOiIjN2MzYWVkIiwicG9zIjoxMDB9XX19LCJ0eXBvZ3JhcGh5Ijp7ImFsaWduIjoiY2VudGVyIn19fQ

Template reference

Every template, its presets, and its slots. Open any of these in the gallery to preview.

General (8)

Announcement `announcement`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A press announcement card: an 'Announcing' badge, a bold statement headline, a supporting subline, an accent divider, and a date + source row with an optional read CTA.

Presets: press (default), daylight, accent

slot id	type	required	max	placeholder
`badge`	text	—	18	Announcing
`title`	multiline	yes	60	Introducing Our Next Chapter
`subtitle`	text	—	90	A faster, simpler way to create — now available to everyone.
`date`	text	—	24	June 2026
`source`	text	—	30	Northwind Newsroom
`cta`	text	—	22	Read the release

Comparison `comparison`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A side-by-side "us vs them" comparison card: a headline over two labeled columns with check/cross feature rows and a verdict pill.

Presets: contrast (default), clean, bold

slot id	type	required	max	placeholder
`title`	text	yes	48	Why teams switch to us
`leftLabel`	text	—	22	The old way
`rightLabel`	text	—	22	Acme
`rows`	multiline	—	140	Realtime sync Offline mode Unlimited seats SSO included
`verdict`	text	—	40	Acme wins on every front

Glass `glass`

supports: background, gradient, typography, logo, platform, noise

A frosted translucent card floating over a colorful gradient or mesh backdrop.

Presets: frosted-dark (default), frosted-light, neon-glass

slot id	type	required	max	placeholder
`badge`	text	—	24	Announcing
`title`	text	yes	70	Your big headline
`subtitle`	multiline	—	130	A short supporting line that explains the headline.

Gradient Mesh `gradient-mesh`

supports: background, gradient, typography, logo, platform, noise, vignette

Soft multi-color mesh backgrounds with bold, centered type.

Presets: aurora (default), sunset, ocean, mono

slot id	type	required	max	placeholder
`badge`	text	—	28	Now in beta
`title`	text	yes	70	Your big headline
`subtitle`	multiline	—	140	A short supporting line

Pattern Grid `pattern-grid`

supports: background, grid, typography, logo, platform, noise

Structured, centered type laid over a dot, blueprint, or isometric grid pattern.

Presets: dotted (default), blueprint, iso-grid

slot id	type	required	max	placeholder
`title`	text	yes	70	Build on a solid grid
`subtitle`	multiline	—	140	A short supporting line that sits neatly under the headline

Photo Overlay `photo-overlay`

supports: background, gradient, image, typography, logo, platform, vignette, noise

A full-bleed background photo with a legibility scrim and a bold bottom-anchored headline, eyebrow, and subtitle.

Presets: bold (default), minimal, film

slot id	type	required	max	placeholder
`photo`	image	—	—	Full-bleed background photo
`eyebrow`	text	—	28	Travel
`title`	multiline	yes	80	A weekend in the Dolomites
`subtitle`	multiline	—	120	Where to stay, what to hike, and the best light.

Personal Brand `portfolio`

supports: background, gradient, grid, image, typography, logo, platform, noise, vignette

A personal-brand card: a big name, a role line, a short bio, a row of skill chips, and a handle/URL line, beside a large circular avatar (letter-mark fallback).

Presets: midnight (default), daylight, sunset

slot id	type	required	max	placeholder
`name`	text	yes	28	Jordan Avery
`role`	text	—	36	Product Designer & Developer
`bio`	multiline	—	96	I craft calm interfaces and design systems for early-stage teams.
`skills`	text	—	50	UI Design · Prototyping · Front-end
`handle`	text	—	40	jordanavery.studio · @jordanmakes
`avatar`	image	—	—	Square headshot (circular crop)

Spotlight `spotlight`

supports: background, gradient, grid, typography, noise, vignette, logo, platform

A dark, dramatic single-message OG card: a small eyebrow, one big statement headline with a single keyword in an accent color, and a short subline, all lit by a large soft radial glow behind the text.

Presets: violet-glow (default), cyan-signal, amber-ember

slot id	type	required	max	placeholder
`eyebrow`	text	—	32	INTRODUCING
`title`	multiline	yes	70	The fastest way to ship
`subtitle`	multiline	—	120	One bold idea, rendered entirely in your browser.

Product (16)

App Hero `app-hero`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A soft, app-store-style hero: a large rounded app icon centered above the app name, a one-line tagline, a star rating, and a Get/Download pill button on a warm light background.

Presets: peach (default), cream, lilac

slot id	type	required	max	placeholder
`appIcon`	image	—	—	Square app icon (a letter-mark is used if empty)
`appName`	text	yes	28	Lumen
`tagline`	text	—	60	Your calmest way to track money
`rating`	text	—	32	4.9 · 12K ratings
`cta`	text	—	16	Get

Bundle Kit `bundle-kit`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A product-bundle card: a bundle badge, kit name, a row of two to four product thumbnails with labelled fallbacks, a large total price with a savings callout, and a short note line.

Presets: studio (default), bold, sale

slot id	type	required	max	placeholder
`badge`	text	—	16	BUNDLE
`name`	multiline	yes	48	The Home Office Starter Kit
`items`	image-list	—	4 items	Add up to 4 product images
`itemNames`	multiline	—	120	Desk lamp Mug warmer Notebook
`total`	text	—	12	$129
`savings`	text	—	16	Save $40
`note`	text	—	36	3 items · ships free

Device Frame `device-frame`

supports: background, gradient, image, typography, logo, platform, vignette

Embed a screenshot inside a browser or phone frame with depth, a title, and a caption.

Presets: browser-dark (default), browser-light, phone, floating

slot id	type	required	max	placeholder
`title`	text	yes	60	Introducing the new dashboard
`screenshot`	image	—	—	Upload a screenshot
`caption`	multiline	—	80	A short supporting line

Marketplace Listing `marketplace-listing`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A peer-to-peer marketplace listing card: an item photo, the title and a big price, a condition pill, a location and posted-time line, and a seller row with a round avatar, name, and star rating.

Presets: marketplace (default), classified, midnight

slot id	type	required	max	placeholder
`title`	multiline	yes	56	Vintage Teak Lounge Chair
`price`	text	—	12	$240
`condition`	text	—	24	Used · Like New
`location`	text	—	36	Portland, OR · 2h ago
`seller`	text	—	24	mid_century_finds
`rating`	text	—	16	4.9 (128)
`avatar`	image	—	—	Seller avatar
`photo`	image	—	—	Item photo

Metrics `metrics`

supports: background, gradient, typography, logo, noise, vignette, platform

A launch-analytics dashboard card whose hero is a row of 2-4 big-number KPI stat cards (value, label, trend delta) under a headline, on a deep-navy background with one vivid accent.

Presets: lime (default), ember, violet

slot id	type	required	max	placeholder
`eyebrow`	text	—	32	Launch recap
`headline`	multiline	yes	70	Our launch day by the numbers
`subtitle`	multiline	—	110	Real-time results from the first 24 hours on the platform.
`stats`	multiline	yes	240	12.4k \| Upvotes \| +18% #1 \| Product of the Day \| 3.2k \| New signups \| +42% 98% \| Satisfaction \| +5%
`footnote`	text	—	48	Updated hourly · first 24h

Onboarding `onboarding-card`

supports: background, gradient, typography, logo, platform, noise, vignette

A clean onboarding card: an eyebrow chip, a friendly headline, a subtitle, three numbered step chips, and a get-started CTA on a soft pastel background.

Presets: mint (default), lilac, peach

slot id	type	required	max	placeholder
`eyebrow`	text	—	22	Getting started
`title`	multiline	yes	48	Set Up Your Workspace in Minutes
`subtitle`	text	—	64	Three quick steps and you're ready to go.
`steps`	multiline	—	120	Create your account Invite your team Connect your tools
`cta`	text	—	20	Get started

Persona `persona`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A bright, energetic marketing hero fronted by a presenter: an accent pill, a big benefit headline with a short subline, and a presenter row of a circular avatar plus name and role.

Presets: violet-pink (default), sunset-rose, coral-mesh

slot id	type	required	max	placeholder
`badge`	text	—	18	AI
`title`	multiline	yes	70	Marketing that runs itself while you build
`subtitle`	multiline	—	120	Turn your idea into a launch-ready campaign in minutes, not weeks.
`avatar`	image	—	—	Square headshot (circular crop)
`name`	text	—	28	Maya Chen
`role`	text	—	32	Founder

Pricing `pricing`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A pricing-plan card: an optional badge, the plan name, a big price with billing period, an included-features checklist, and a CTA.

Presets: indigo (default), emerald, noir

slot id	type	required	max	placeholder
`badge`	text	—	22	Most popular
`plan`	text	yes	24	Pro
`price`	text	yes	12	$29
`period`	text	—	16	per month
`features`	multiline	—	160	Unlimited projects Priority support Custom domains Advanced analytics
`cta`	text	—	24	Start free trial

Product Card `product-card`

supports: background, gradient, image, typography, logo, platform, vignette, noise

An e-commerce product card: brand eyebrow, product name, a prominent price, a note and an optional badge beside a clean product photo with a soft shadow.

Presets: studio (default), boutique, sale

slot id	type	required	max	placeholder
`brand`	text	—	24	NORTHWIND
`name`	multiline	yes	60	Aero Running Jacket
`price`	text	—	16	$128
`note`	text	—	32	Free shipping over $75
`badge`	text	—	16	New
`photo`	image	—	—	Product photo

Product Deal `product-deal`

supports: background, gradient, image, typography, logo, platform, vignette, noise

A price-drop deal card: a deal badge, brand eyebrow, product name, a struck-through was-price beside a big accent now-price, a percent-off badge, an urgency line and an optional product photo with a soft shadow.

Presets: flash (default), holiday, clearance

slot id	type	required	max	placeholder
`badge`	text	—	16	DEAL
`brand`	text	—	24	NORTHWIND
`name`	multiline	yes	56	Trailridge 30L Backpack
`wasPrice`	text	—	12	$199
`nowPrice`	text	—	12	$129
`discount`	text	—	12	35% OFF
`urgency`	text	—	32	Ends Sunday · while stocks last
`photo`	image	—	—	Product photo

Product Launch `product-launch`

supports: background, gradient, image, typography, logo, platform, vignette

A launch announcement with a 'New' badge, bold title, subtitle, CTA chip, and an optional product image.

Presets: spotlight (default), split, centered-hero

slot id	type	required	max	placeholder
`badge`	text	—	18	New
`title`	text	yes	70	Meet your next favorite tool
`subtitle`	multiline	—	130	A short line about what makes it great
`cta`	text	—	24	Get started free
`productImage`	image	—	—	—

Product Review `product-review`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A square-first physical-product card: a bestseller badge, product photo, name, a now/was price, a star rating with review count, a checkmark feature list, and a brand logo in the bottom-left.

Presets: bestseller (default), midnight, warm

slot id	type	required	max	placeholder
`badge`	text	—	18	BESTSELLER
`title`	multiline	yes	48	Premium Wireless Headphones
`nowPrice`	text	—	12	$199
`wasPrice`	text	—	12	$269
`rating`	text	—	24	4.8/5 (256 reviews)
`features`	multiline	—	140	Active Noise Cancellation 30-hour Battery Life Premium Sound Quality
`photo`	image	—	—	Product photo
`logo`	image	—	—	Brand logo
`brand`	text	—	20	NORTHWIND

SaaS `saas`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A SaaS marketing card: app lockup (mark + product name), a big value-prop headline, a subtitle, a row of feature pills, and a social-proof line.

Presets: indigo (default), mint, midnight

slot id	type	required	max	placeholder
`product`	text	—	28	Tasklane
`title`	multiline	yes	80	Plan, Track, and Ship Faster
`subtitle`	multiline	—	130	One fast workspace for your whole product team.
`features`	multiline	—	120	Realtime sync Keyboard-first Git integration
`proof`	text	—	48	Trusted by 2,000+ teams

SaaS Dark `saas-dark`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A sleek dark SaaS hero: a product lockup with a New badge, a bold value headline, a subtitle, a feature dot-list, and a Start CTA, beside a drawn dashboard widget (a mini area chart + two KPI tiles).

Presets: aurora (default), ember, mono

slot id	type	required	max	placeholder
`badge`	text	—	12	New
`product`	text	—	20	Lumenstack
`title`	multiline	yes	52	Analytics Your Whole Team Trusts
`subtitle`	text	—	70	Realtime dashboards with zero setup.
`features`	multiline	—	120	Live metrics Team workspaces Audit-ready logs
`cta`	text	—	20	Start free

Sale `sale`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A bold sale/discount promo card: a limited-time badge, a huge discount headline, a subline, an optional dashed coupon-code chip, and a shop CTA.

Presets: hot (default), electric, midnight

slot id	type	required	max	placeholder
`badge`	text	—	22	Limited time
`headline`	text	yes	24	50% OFF
`subtitle`	multiline	—	110	Everything in the summer collection — this weekend only.
`code`	text	—	18	SUMMER50
`cta`	text	—	22	Shop the sale

Social Proof `social-proof`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A clean light-mode SaaS marketing card with a status badge, logo, big dark headline, rating stars, and a green-check feature checklist that signals trust and social proof.

Presets: daylight (default), linen, powder

slot id	type	required	max	placeholder
`badge`	text	—	22	Trusted by teams
`logo`	image	—	—	Logo
`headline`	multiline	yes	72	The toolkit teams switch to and stay on
`subtext`	multiline	—	130	One workspace for docs, tasks, and reviews. Set up in minutes, loved for years.
`rating`	text	—	5	5.0
`ratingNote`	text	—	34	from 1,200+ reviews
`features`	multiline	—	120	Realtime collaboration Unlimited projects Works offline
`accent`	text	—	20	Free 14-day trial

Education (5)

Cohort Course `cohort`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A cohort-based course card: a kicker pill, a big course title, an instructor line, two structured info cards (start date + duration), a 'seats left' urgency pill with a progress bar, and an apply CTA.

Presets: cobalt (default), pine, noir

slot id	type	required	max	placeholder
`kicker`	text	—	26	Cohort-based course
`title`	multiline	yes	64	Product Design Intensive
`instructor`	text	—	40	Led by Dana Brooks
`startLabel`	text	—	24	Sep 8, 2026
`duration`	text	—	30	6 weeks · Live
`seats`	text	—	30	12 of 40 seats left
`cta`	text	—	22	Apply now

Course `course`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

An online-course / lesson share card: an eyebrow, a big course title, an instructor line, a meta row of pills (lessons, duration, level), and an enroll CTA.

Presets: indigo (default), forest, plum

slot id	type	required	max	placeholder
`kicker`	text	—	28	Online course
`title`	multiline	yes	70	Build a Design System in Figma
`instructor`	text	—	40	with Dana Lee
`meta`	text	—	60	12 lessons · 4h 30m · Beginner
`cta`	text	—	24	Enroll free

Curriculum `curriculum`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A course curriculum / syllabus card: a left header (kicker, course title, a meta line, and a CTA) beside a right column of numbered modules each with a duration chip.

Presets: paper (default), indigo, carbon

slot id	type	required	max	placeholder
`kicker`	text	—	26	Course syllabus
`title`	multiline	yes	50	Frontend Architecture
`meta`	text	—	48	8 modules · 6h 20m · Beginner
`modules`	multiline	—	220	Foundations \| 42m Component patterns \| 1h 05m State & data flow \| 58m
`cta`	text	—	22	View curriculum

Video Lesson `lesson`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A single video-lesson card: a series eyebrow, a big lesson title, a course meta line, beside a video thumbnail panel with a centered play button and a duration badge.

Presets: midnight (default), plum, slate

slot id	type	required	max	placeholder
`series`	text	—	40	Design Systems · Lesson 4
`title`	multiline	yes	56	Tokens, Themes, and Dark Mode
`meta`	text	—	40	12 lessons · 4h 30m
`duration`	text	—	10	14:32
`thumb`	image	—	—	Video thumbnail

Webinar `webinar`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A live webinar / masterclass card: a LIVE badge with a pulsing dot, a big topic title, a presenter row (avatar with letter fallback, name + role), a date/time chip, and a register CTA.

Presets: daylight (default), indigo, charcoal

slot id	type	required	max	placeholder
`badge`	text	—	18	Live webinar
`title`	multiline	yes	70	Scaling Design Systems Without the Chaos
`presenter`	text	—	36	Maya Chen
`role`	text	—	40	Head of Design, Northwind
`datetime`	text	—	40	Thu, Jul 10 · 11:00 AM PT
`cta`	text	—	22	Save my seat
`avatar`	image	—	—	Square headshot

Finance (5)

Token Price `crypto-token`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A token price card: a token lockup (letter-mark coin + name + ticker chip), a big price, a 24h change pill (green up / red down) with arrow, a sparkline, and a stat row of pills (market cap, volume, rank).

Presets: neon (default), violet, gold

slot id	type	required	max	placeholder
`name`	text	yes	24	Zelphor
`ticker`	text	—	8	ZPH
`price`	text	yes	12	$2.418
`change`	text	—	14	+12.4%
`stats`	text	—	60	Mkt Cap $1.2B · Vol $84M · Rank #42
`note`	text	—	20	24h · USD

Fintech App `fintech-app`

supports: background, gradient, typography, logo, platform, noise, vignette

A fintech app hero: a product lockup, a value headline + subtitle, a short feature list, and a Get-the-app CTA, beside a drawn gradient payment card (label, masked number, holder, chip).

Presets: emerald (default), indigo, sunset

slot id	type	required	max	placeholder
`product`	text	—	20	Plume
`title`	multiline	yes	42	Banking That Grows With You
`subtitle`	text	—	56	No fees, no minimums — just smarter money.
`features`	multiline	—	120	Instant transfers Get paid 2 days early 2.5% cashback
`cardLabel`	text	—	20	Plume Card
`holder`	text	—	24	A. MORGAN
`cta`	text	—	22	Get the app

Funding Round `funding-round`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A funding-round announcement card: a round badge, a "we raised" eyebrow, a huge amount, a company lockup, an investors line, a use-of-funds tagline, and an optional CTA.

Presets: spotlight (default), indigo, daylight

slot id	type	required	max	placeholder
`badge`	text	—	14	Series A
`eyebrow`	text	—	18	We raised
`amount`	text	yes	10	$12M
`company`	text	—	22	Lumenstack
`investors`	text	—	64	Led by Vantage Capital, with Meadow Ventures
`tagline`	multiline	yes	64	Building the fastest analytics stack for modern teams.
`cta`	text	—	20	We are hiring

Invoice `invoice`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

An invoice card styled as a document: a business lockup and INVOICE title, an invoice number with issued and due dates, a bill-to line, a table of line items with amounts, a totals block, and a PAID stamp.

Presets: paper (default), slate, noir

slot id	type	required	max	placeholder
`business`	text	yes	24	Brightloom Studio
`invoiceNo`	text	—	16	INV-0142
`issued`	text	—	22	Issued Jun 3
`due`	text	—	22	Due Jun 17
`billTo`	text	—	30	Bill to: Northwind Co.
`items`	multiline	—	160	Brand identity system \| $1,400 Landing page design \| $820 Two revision rounds \| $260 Asset handoff \| $0
`total`	text	—	14	$2,480.00
`status`	text	—	12	PAID

Market Update `market-update`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A market update card: an eyebrow, a headline, a date, then a clean movers list (invented company name + price + green/red % change), and a muted footnote.

Presets: newsprint (default), terminal, slate

slot id	type	required	max	placeholder
`eyebrow`	text	—	20	Market update
`title`	multiline	yes	56	Markets Close Higher on Tech Rally
`date`	text	—	30	Jun 19 · 4:00 PM ET
`movers`	multiline	—	240	Helio Labs \| $182.40 \| +3.2% Vantage Group \| $54.10 \| -1.1% Meadow Energy \| $77.85 \| +0.8% Orbit Mobility \| $12.66 \| +5.4%
`footer`	text	—	44	Closing prices · illustrative sample data

Real Estate (2)

Open House `open-house`

supports: background, gradient, image, typography, logo, platform, noise, vignette

An open-house flyer: a bold OPEN HOUSE badge, the home title, a property photo, a prominent date/time and address, and a host line with an optional detail.

Presets: warm (default), navy, sage

slot id	type	required	max	placeholder
`badge`	text	—	16	Open House
`title`	multiline	yes	42	Modern Hillside Retreat
`datetime`	text	—	34	Sat, Jul 12 · 1–4 PM
`address`	text	—	48	17 Canyon View Dr, Boulder
`host`	text	—	40	Hosted by Erin Park
`detail`	text	—	40	Refreshments served · All welcome
`photo`	image	—	—	Property photo

Property Listing `property-listing`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A real-estate listing card: a property photo, a status pill, a big price, the home title, an address line, a specs row (beds · baths · sqft with icons), and an agent line.

Presets: classic (default), modern, coastal

slot id	type	required	max	placeholder
`status`	text	—	16	For Sale
`price`	text	—	14	$845,000
`title`	multiline	yes	40	Sunlit 3-Bed Craftsman
`address`	text	—	48	248 Maple Crest Ave, Lakewood
`specs`	text	—	40	3 Beds · 2 Baths · 1,840 sqft
`agent`	text	—	48	Listed by Erin Park · Crestline Realty
`photo`	image	—	—	Property photo

Jobs (2)

Job Posting `job-posting`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A job posting card: a company lockup, a big role title, a meta row of pills (location, type, salary), a short list of highlights, and an Apply CTA.

Presets: daylight (default), indigo, slate

slot id	type	required	max	placeholder
`company`	text	—	24	Northwind Labs
`role`	multiline	yes	44	Senior Frontend Engineer
`meta`	text	—	48	Remote · Full-time · $140k–$180k
`points`	multiline	—	120	React + TypeScript 4+ years experience Equity + full benefits
`cta`	text	—	20	Apply now

We're Hiring `were-hiring`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A bold 'we're hiring' announcement: a hiring badge, a big statement, a list of open roles as pills, a perks line, and a see-roles CTA.

Presets: electric (default), sunset, midnight

slot id	type	required	max	placeholder
`badge`	text	—	18	We're hiring
`title`	multiline	yes	40	Come Build With Us
`roles`	multiline	—	120	Product Designer Backend Engineer Growth Lead Support Specialist
`perks`	text	—	56	Remote-first · Equity · Unlimited PTO
`company`	text	—	24	Brightloom
`cta`	text	—	22	See open roles

Food (3)

Restaurant Menu `menu`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A restaurant menu card: a section eyebrow, the restaurant name, a list of dishes each with a name and price (dotted leader between), and a muted note.

Presets: charcoal (default), linen, garden

slot id	type	required	max	placeholder
`kicker`	text	—	22	Dinner Menu
`name`	text	yes	28	Olive & Thyme
`items`	multiline	—	220	Charred Octopus \| 18 Wild Mushroom Risotto \| 24 Seared Branzino \| 29
`note`	text	—	40	Seasonal · Locally sourced

Recipe `recipe`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A recipe share card: an eyebrow, the dish name, a meta row (time, servings, difficulty), a short ingredient list in two columns, and an optional source line.

Presets: saffron (default), basil, charcoal

slot id	type	required	max	placeholder
`kicker`	text	—	24	Recipe
`title`	multiline	yes	60	One-Pan Lemon Garlic Pasta
`meta`	text	—	50	25 min · Serves 4 · Easy
`ingredients`	multiline	—	160	Spaghetti Garlic Lemon Parmesan Olive oil Parsley
`source`	text	—	40	from The Weeknight Kitchen

Restaurant Hero `restaurant-hero`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A restaurant brand hero: the restaurant name, a cuisine tagline, a star rating with review count, a details line (hours/location), and a reserve CTA, beside a food photo.

Presets: terracotta (default), charcoal, fresh

slot id	type	required	max	placeholder
`name`	multiline	yes	22	Olive & Thyme
`cuisine`	text	—	44	Mediterranean Kitchen & Bar
`rating`	text	—	28	4.8 · 1,200+ reviews
`detail`	text	—	40	Open 5–11 PM · Downtown
`cta`	text	—	20	Reserve a table
`photo`	image	—	—	Food photo

Travel (3)

Destination Postcard `destination-postcard`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A vintage travel-postcard card: a full-bleed destination photo inside a thick postcard border, with a "Greetings from" eyebrow, a big serif place name, a region subline, a coordinates line, and a stamp graphic in the corner.

Presets: coastal (default), sunset, alpine

slot id	type	required	max	placeholder
`eyebrow`	text	—	18	Greetings from
`title`	text	yes	22	Marisol Bay
`subtitle`	text	—	36	The Southern Coast
`coordinates`	text	—	26	41.2 N / 9.1 E
`photo`	image	—	—	—

Trip Itinerary `itinerary`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A trip itinerary card: a left summary (kicker, trip title, a meta row of pills) beside a right vertical timeline of auto-numbered days, each a connected dot with a short activity line.

Presets: paper (default), ocean, forest

slot id	type	required	max	placeholder
`kicker`	text	—	18	Itinerary
`title`	multiline	yes	40	7 Days in the Highlands
`meta`	text	—	44	Apr 2 - 9 · 2 travelers · 6 stops
`days`	multiline	—	160	Arrive + old town wander Coastal cliffs day trip Vineyards + sunset dinner Markets + departure
`cta`	text	—	20	Plan your trip

Travel Deal `travel-deal`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A travel deal card: a deal badge, an origin to destination route drawn as a dotted flight arc with a plane icon, a travel-dates line, a big fare price with a per-person note, an optional detail line, and a book CTA.

Presets: skyline (default), sunset, midnight

slot id	type	required	max	placeholder
`badge`	text	—	16	Flight Deal
`origin`	text	yes	18	Harborview
`destination`	text	yes	18	Porto Verde
`dates`	text	—	30	Mar 14 - Mar 22
`price`	text	—	10	$389
`priceNote`	text	—	24	per person, round trip
`detail`	text	—	30	Nonstop · 11h 20m
`cta`	text	—	18	Book now

Health & Fitness (3)

Fitness App `fitness-app`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A fitness/health app hero: a product lockup with a badge, a value headline, a subtitle, a headline stat row, and a get-the-app CTA, beside a drawn activity-rings widget with two mini stats.

Presets: pulse (default), mint, sunrise

slot id	type	required	max	placeholder
`badge`	text	—	12	Health
`product`	text	—	18	Pulse
`title`	multiline	yes	44	Every Move Counts, Daily
`subtitle`	text	—	64	Train, recover, and sleep in one app.
`stats`	multiline	—	90	24 \| Workouts 18 \| Day streak 7h \| Avg sleep
`cta`	text	—	18	Get the app

Nutrition Facts `nutrition-facts`

supports: background, gradient, typography, logo, platform, noise, vignette

A nutrition-facts card: a left product column (name, tagline, highlight pills) beside a classic nutrition-label panel with a serving size, a big calories number, nutrient rows with percent daily value, and a footnote.

Presets: fresh (default), citrus, berry

slot id	type	required	max	placeholder
`product`	text	yes	22	Cold-Pressed Greens
`tagline`	text	—	52	Organic juice, nothing added.
`highlights`	multiline	—	60	Vegan Gluten-free No added sugar
`serving`	text	—	28	1 bottle (350 ml)
`calories`	text	—	8	120
`nutrients`	multiline	—	150	Total Fat \| 0 g \| 0% Sodium \| 35 mg \| 2% Total Carbs \| 26 g \| 9% Sugars \| 18 g \| - Protein \| 3 g \| 6% Vitamin C \| 90 mg \| 100%
`footnote`	text	—	60	Percent daily values based on a 2,000 calorie diet.

Workout Class `workout-class`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A fitness class card: a class-type kicker, a bold class name, an instructor line, a row of stat blocks (duration, an intensity meter, calories), a schedule line, and a reserve CTA.

Presets: energy (default), sunrise, cool

slot id	type	required	max	placeholder
`kicker`	text	—	22	HIIT · Studio 2
`title`	multiline	yes	26	Sunrise Burn
`instructor`	text	—	28	with Coach Rae
`stats`	multiline	—	90	45 min \| Duration High \| Intensity 520 \| Calories
`schedule`	text	—	34	Mon + Wed · 6:30 AM
`cta`	text	—	20	Reserve a spot
`avatar`	image	—	—	—

Music (3)

Album Release `album-release`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A music release card: a square album-art panel (with a drawn vinyl fallback) beside an out-now badge, an artist name, a big album/track title, a meta row (genre, tracks, runtime), and a listen CTA.

Presets: neon (default), sunset, mono

slot id	type	required	max	placeholder
`badge`	text	—	14	Out Now
`artist`	text	yes	24	Velvet Harbor
`title`	multiline	yes	32	Midnight Tides
`meta`	text	—	42	Indie Pop · 12 tracks · 41 min
`cta`	text	—	18	Listen now
`cover`	image	—	—	—

Now Playing `now-playing`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A now-playing music-player card: a small album thumbnail, the track and artist, a progress bar with elapsed and total timestamps, drawn transport controls, and a waveform, styled as a streaming player.

Presets: verdant (default), violet, amber

slot id	type	required	max	placeholder
`track`	text	yes	30	Neon Rivers
`artist`	text	yes	24	Velvet Harbor
`album`	text	—	26	Midnight Tides
`elapsed`	text	—	6	1:24
`total`	text	—	6	3:47
`upNext`	text	—	30	Up next: Coastal Lights
`cover`	image	—	—	—

Tour Dates `tour-dates`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A concert tour poster card: a tour eyebrow, a big artist/tour name, a list of tour stops (date, city/venue, and a tickets or sold-out tag), and a get-tickets CTA.

Presets: spotlight (default), punk, festival

slot id	type	required	max	placeholder
`eyebrow`	text	—	22	World Tour 2026
`title`	multiline	yes	26	Velvet Harbor
`dates`	multiline	—	200	MAR 14 \| Harborview, Tidal Hall \| Tickets
`cta`	text	—	18	Get tickets

Video & Creator (3)

Creator Milestone `creator-milestone`

supports: background, gradient, typography, logo, platform, noise, vignette

A creator milestone card: a milestone badge, a huge number with a unit label, a thank-you headline, a creator row (avatar + handle), and drawn confetti accents.

Presets: confetti (default), gold, mint

slot id	type	required	max	placeholder
`badge`	text	—	14	Milestone
`number`	text	yes	8	100K
`unit`	text	—	18	Subscribers
`title`	multiline	yes	40	Thank You for the Support
`handle`	text	—	22	@thedailybuild
`subline`	text	—	50	Couldn’t have done it without you.
`avatar`	image	—	—	—

Going Live `going-live`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A going-live stream card: a pulsing LIVE badge, a viewer-count chip, a going-live eyebrow, a big stream title, a streamer row (avatar + handle), a schedule line, and a watch CTA, in a neon stream-overlay style.

Presets: neon (default), acid, cobalt

slot id	type	required	max	placeholder
`badge`	text	—	10	LIVE
`eyebrow`	text	—	18	Going Live
`title`	multiline	yes	40	Building a Synth From Scratch
`handle`	text	—	22	@nimbusplays
`viewers`	text	—	18	1.2K watching
`schedule`	text	—	30	Today · 8:00 PM ET
`cta`	text	—	18	Watch now
`avatar`	image	—	—	—

Video Thumbnail `video-thumbnail`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A bold video-thumbnail card: a huge punchy headline with one highlighted accent word, a creator face slot (with an avatar fallback), a circle-and-arrow accent, a channel line, and a duration badge.

Presets: punch (default), gamer, clean

slot id	type	required	max	placeholder
`title`	multiline	yes	38	I Tried This For 30 Days
`highlight`	text	—	16	30 Days
`badge`	text	—	8	NEW
`channel`	text	—	22	The Daily Build
`photo`	image	—	—	—

Gaming (5)

Esports Match-Up `esports-matchup`

supports: background, gradient, grid, image, typography, logo, platform, noise, vignette

An esports versus card: a tournament eyebrow, two teams with optional logos, a central VS with the score, and a detail line for the round, format, time, or LIVE status.

Presets: arena (default), stadium, classic

slot id	type	required	max	placeholder
`tournament`	text	—	40	Nova Invitational · Grand Final
`teamA`	text	yes	22	Crimson Vanguard
`teamB`	text	yes	22	Azure Syndicate
`scoreA`	text	—	4	2
`scoreB`	text	—	4	1
`status`	text	—	16	LIVE
`detail`	text	—	48	Map 4 · 7:30 PM ET
`logoA`	image	—	—	Team A logo
`logoB`	image	—	—	Team B logo

Game Release `game-release`

supports: background, gradient, image, typography, logo, platform, noise, vignette

A game announcement card: a status badge, a big game title, a one-line tagline, genre pills, generic platform chips, a release date, and optional key art.

Presets: neon (default), fantasy, sci-fi

slot id	type	required	max	placeholder
`badge`	text	—	16	OUT NOW
`title`	multiline	yes	48	Echoes of the Verge
`tagline`	multiline	—	90	A co-op survival roguelite set on a dying frontier.
`genres`	multiline	—	80	Roguelite Survival Co-op
`platforms`	text	—	40	PC · Console · Cloud
`date`	text	—	28	Available March 2026
`art`	image	—	—	Key art

Game Server `game-server`

supports: background, gradient, grid, image, typography, logo, platform, noise, vignette

A multiplayer game-server status card with a live online/offline dot, the server name, a mono connect address, a big player count with a capacity bar, the game mode and tag pills, over an optional banner image.

Presets: survival (default), hardcore, creative

slot id	type	required	max	placeholder
`name`	text	yes	32	Ironhold Survival
`status`	text	—	16	Online
`address`	text	—	40	play.ironhold.example:30420
`players`	text	—	12	37 / 64
`mode`	text	—	24	Survival · PvE
`tags`	multiline	—	120	Modded Whitelist Weekly resets
`banner`	image	—	—	Banner art

Leaderboard `leaderboard`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A gaming leaderboard card: a season eyebrow and title over a ranked list of players with rank numbers (gold/silver/bronze for the top three), names, and scores, with the leader highlighted.

Presets: arena (default), inferno, toxic

slot id	type	required	max	placeholder
`eyebrow`	text	—	20	Season 4 · Ranked
`title`	multiline	yes	26	Top Players
`entries`	multiline	—	180	NovaStrike \| 18,420 Vortex \| 17,905 EmberWolf \| 16,330
`note`	text	—	36	Updated hourly · Top 100 qualify

Tournament Bracket `tournament-bracket`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A tournament bracket card: an eyebrow and title over a drawn four-team single-elimination bracket (two semifinals with scores, connector lines feeding a final), ending in a highlighted champion slot.

Presets: arena (default), neon, ember

slot id	type	required	max	placeholder
`eyebrow`	text	—	22	Grand Finals
`title`	multiline	yes	24	Bracket Stage
`teams`	multiline	—	120	Nova \| 2 Vortex \| 1 Ember \| 0 Quill \| 2
`champion`	text	—	16	Quill
`prize`	text	—	24	$50,000 Prize Pool

Editorial (5)

Article Card `article-card`

supports: background, gradient, grid, image, typography, logo, platform, noise, vignette

A clean blog/article share card with a category tag, a big headline, an optional excerpt, and an author row (avatar, name, read time).

Presets: ink (default), paper, gradient

slot id	type	required	max	placeholder
`category`	text	—	24	Engineering
`title`	multiline	yes	90	How we cut our build times in half
`excerpt`	multiline	—	140	A short summary that pulls readers in.
`author`	text	—	40	Jordan Lee
`meta`	text	—	40	5 min read
`avatar`	image	—	—	Author photo

Editorial `editorial`

supports: background, image, typography, logo, platform, vignette

A magazine split layout with a kicker, big headline and byline beside a featured photo.

Presets: magazine (default), newsprint, long-read

slot id	type	required	max	placeholder
`kicker`	text	—	30	Section / category
`headline`	text	yes	90	Your big headline goes here
`byline`	text	—	48	By Author Name · Publication
`photo`	image	—	—	Featured image

How-To `how-to`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A numbered step-by-step tutorial card: an eyebrow, a title, and up to four numbered steps in a vertical list, with an optional footer.

Presets: cobalt (default), sunrise, slate

slot id	type	required	max	placeholder
`kicker`	text	—	24	Tutorial
`title`	multiline	yes	64	Deploy a Next.js app in 4 steps
`steps`	multiline	—	200	Install the CLI Connect your repo Set your env vars Click deploy
`footer`	text	—	40	freeogimage.com/guides

Minimal Type `minimal-type`

supports: background, gradient, typography, logo, platform

Whitespace-forward Swiss editorial layout with a tiny eyebrow, a very large headline, and a quiet footer line.

Presets: swiss (default), serif-editorial, bold-sans

slot id	type	required	max	placeholder
`eyebrow`	text	—	30	Issue 01 — Field Notes
`title`	text	yes	80	A headline that earns the whitespace around it
`footer`	text	—	48	freeogimage.com / June 2026

Newsletter `newsletter`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A newsletter-issue share card: a masthead with an envelope mark, an issue/date line, a big headline, and a dek, with an optional read-online CTA.

Presets: paper (default), ink, mint

slot id	type	required	max	placeholder
`masthead`	text	—	30	The Weekly Byte
`issue`	text	—	36	Issue #42 · June 2026
`title`	multiline	yes	80	The state of web performance in 2026
`dek`	multiline	—	150	Core Web Vitals, RSC, and the tools worth your attention this month.
`cta`	text	—	24	Read online

Developer (6)

API Reference `api-reference`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

An API reference card: an 'API Reference' eyebrow, a METHOD badge with a mono endpoint path, a title and description, and a rounded code panel showing a faux JSON response.

Presets: indigo (default), emerald, slate

slot id	type	required	max	placeholder
`badge`	text	—	18	API Reference
`method`	text	—	8	GET
`path`	text	—	40	/v1/images/generate
`title`	multiline	yes	40	Generate an Image
`description`	text	—	80	Create a new render from a template id and slot values.
`code`	multiline	—	160	{ "id": "img_8f2a", "status": "ready" }

Changelog `changelog`

supports: background, gradient, grid, typography, logo, platform

Release-notes card with a version chip, headline, and an accented bullet list.

Presets: vibrant (default), mono, bordered

slot id	type	required	max	placeholder
`version`	text	—	16	v2.4.0
`title`	text	yes	70	What's new in this release
`bullets`	multiline	—	200	New dark mode Faster exports Bug fixes

Dark Terminal `dark-terminal`

supports: background, grid, typography, logo, platform, noise

Terminal/IDE aesthetic with monospace type, window chrome, and a neon prompt.

Presets: classic-green (default), dracula, nord, solarized

slot id	type	required	max	placeholder
`prompt`	text	—	6	$
`command`	text	yes	60	npx create-awesome-app
`output`	multiline	—	160	✓ Ready in 0.3s
`filename`	text	—	28	~/projects

Dev Tool `dev-tool`

supports: background, gradient, typography, logo, platform, noise, vignette, image

A developer-tool hero card: split layout with a left product lockup, headline, tagline, and feature tags, beside a synthetically drawn faux browser inspector panel with a highlighted element and a CSS-line tooltip.

Presets: cyan (default), emerald, midnight

slot id	type	required	max	placeholder
`product`	text	—	26	Inspectly
`title`	multiline	yes	64	Inspect any element in one click
`subtitle`	multiline	—	120	A browser inspector that shows you the exact classes behind every pixel.
`features`	multiline	—	90	Live edit Class autocomplete Dark mode
`addressBar`	text	—	40	localhost:3000
`selector`	text	—	32	.btn-primary
`cssLine`	text	—	40	padding: 12px 22px
`screenshot`	image	—	—	Optional — replaces the faux inspector panel

Glossary `glossary`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A developer glossary card that presents a tech term like a dictionary entry — category tag, big headword, pronunciation/part-of-speech line, and a definition body — in a dark, syntax-accented dev aesthetic.

Presets: midnight-lime (default), carbon-cyan, slate-magenta

slot id	type	required	max	placeholder
`tag`	text	—	24	TERM
`term`	text	yes	28	Idempotent
`pronunciation`	text	—	48	/aɪˈdɛm.pə.tənt/ · adjective
`definition`	multiline	yes	220	An operation that produces the same result no matter how many times it is applied. Calling it once or a hundred times leaves the system in the same state.

Repo Card `repo-card`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

An open-source repo card: a repo lockup (repo icon + owner/name), a description, a row of topic tags, and a stat row (stars, forks, and a language with a colored dot).

Presets: carbon (default), midnight, forest

slot id	type	required	max	placeholder
`repo`	text	yes	30	northwind/aurora
`description`	multiline	—	110	A tiny, fast state manager for modern web apps — zero boilerplate.
`topics`	text	—	50	state · hooks · ui
`stars`	text	—	10	12.4k
`forks`	text	—	10	840
`language`	text	—	18	TypeScript

Social (4)

Event Card `event`

supports: background, gradient, image, typography, logo, platform, vignette

Podcast, talk, or webinar card with a title, host, date-time, and a rounded cover image.

Presets: talk (default), episode, webinar

slot id	type	required	max	placeholder
`title`	text	yes	80	The Future of Frontend
`host`	text	—	48	with Jane Doe
`datetime`	text	—	40	Thu, Jun 26 · 6:00 PM PT
`cover`	image	—	—	Square cover image

Logo Wall `logo-wall`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A "trusted by / featured in" directory card: headline plus a tidy grid of rounded-square letter-mark logo tiles parsed from a brand list, with an optional count line.

Presets: violet (default), sunset, midnight

slot id	type	required	max	placeholder
`headline`	text	yes	42	List your SaaS
`subtitle`	multiline	—	130	Get discovered by founders, makers, and buyers in the fastest-growing software directory.
`logos`	image-list	—	12 items	Add logo
`brands`	multiline	—	160	Nimbus Quill Orbit Pineline Vaultly Draftbox
`count`	text	—	48	Join 1,200+ tools already listed

Quote `quote`

supports: background, gradient, image, typography, logo, platform

A large pull-quote with a big opening quote mark, author name, role, and round avatar.

Presets: big-quote (default), card, centered

slot id	type	required	max	placeholder
`quote`	multiline	yes	220	Good ideas earn their place; everything else is just noise.
`author`	text	—	40	Adrian Mercer
`role`	text	—	48	Design Lead, Lumenstack
`avatar`	image	—	—	Square headshot

Testimonial Wall `testimonial-wall`

supports: background, gradient, grid, typography, logo, platform, noise, vignette

A testimonial wall: a headline and subtitle over a 2×2 grid of short quote cards, each with a small avatar letter-mark, a name, and a role.

Presets: daylight (default), violet, midnight

slot id	type	required	max	placeholder
`headline`	text	yes	40	Loved by Teams Everywhere
`subtitle`	text	—	56	Real words from people who switched.
`testimonials`	multiline	—	300	Cut our setup time in half. \| Maya Chen, Northwind The best tool we've adopted this year. \| Leo Park, Vantage Our team actually enjoys using it. \| Sara Ode, Meadow Support is genuinely incredible. \| Tom Reed, Orbit

Quick start

HTTP endpoint

Config schema

Global options

Platform sizes

Fonts

In-browser SDK

Worked examples

Template reference

General (8)

Announcement announcement

Comparison comparison

Glass glass

Gradient Mesh gradient-mesh

Pattern Grid pattern-grid

Photo Overlay photo-overlay

Personal Brand portfolio

Spotlight spotlight

Product (16)

App Hero app-hero

Bundle Kit bundle-kit

Device Frame device-frame

Marketplace Listing marketplace-listing

Metrics metrics

Onboarding onboarding-card

Persona persona

Pricing pricing

Product Card product-card

Product Deal product-deal

Product Launch product-launch

Product Review product-review

SaaS saas

SaaS Dark saas-dark

Sale sale

Social Proof social-proof

Education (5)

Cohort Course cohort

Course course

Curriculum curriculum

Video Lesson lesson

Webinar webinar

Finance (5)

Token Price crypto-token

Fintech App fintech-app

Funding Round funding-round

Invoice invoice

Market Update market-update

Real Estate (2)

Open House open-house

Property Listing property-listing

Jobs (2)

Job Posting job-posting

We're Hiring were-hiring

Food (3)

Restaurant Menu menu

Recipe recipe

Restaurant Hero restaurant-hero

Travel (3)

Destination Postcard destination-postcard

Trip Itinerary itinerary

Travel Deal travel-deal

Health & Fitness (3)

Fitness App fitness-app

Nutrition Facts nutrition-facts

Workout Class workout-class

Music (3)

Album Release album-release

Now Playing now-playing

Tour Dates tour-dates

Video & Creator (3)

Creator Milestone creator-milestone

Going Live going-live

Video Thumbnail video-thumbnail

Gaming (5)

Esports Match-Up esports-matchup

Game Release game-release

Game Server game-server

Leaderboard leaderboard

Tournament Bracket tournament-bracket

Editorial (5)

Announcement `announcement`

Comparison `comparison`

Glass `glass`

Gradient Mesh `gradient-mesh`

Pattern Grid `pattern-grid`

Photo Overlay `photo-overlay`

Personal Brand `portfolio`

Spotlight `spotlight`

App Hero `app-hero`

Bundle Kit `bundle-kit`

Device Frame `device-frame`

Marketplace Listing `marketplace-listing`

Metrics `metrics`

Onboarding `onboarding-card`

Persona `persona`

Pricing `pricing`

Product Card `product-card`

Product Deal `product-deal`

Product Launch `product-launch`

Product Review `product-review`

SaaS `saas`

SaaS Dark `saas-dark`

Sale `sale`

Social Proof `social-proof`

Cohort Course `cohort`

Course `course`

Curriculum `curriculum`

Video Lesson `lesson`

Webinar `webinar`

Token Price `crypto-token`

Fintech App `fintech-app`

Funding Round `funding-round`

Invoice `invoice`

Market Update `market-update`

Open House `open-house`

Property Listing `property-listing`

Job Posting `job-posting`

We're Hiring `were-hiring`

Restaurant Menu `menu`

Recipe `recipe`

Restaurant Hero `restaurant-hero`

Destination Postcard `destination-postcard`

Trip Itinerary `itinerary`

Travel Deal `travel-deal`

Fitness App `fitness-app`

Nutrition Facts `nutrition-facts`

Workout Class `workout-class`

Album Release `album-release`

Now Playing `now-playing`

Tour Dates `tour-dates`

Creator Milestone `creator-milestone`

Going Live `going-live`

Video Thumbnail `video-thumbnail`

Esports Match-Up `esports-matchup`

Game Release `game-release`

Game Server `game-server`

Leaderboard `leaderboard`

Tournament Bracket `tournament-bracket`

Article Card `article-card`

Editorial `editorial`

How-To `how-to`

Minimal Type `minimal-type`

Newsletter `newsletter`

API Reference `api-reference`

Changelog `changelog`

Dark Terminal `dark-terminal`

Dev Tool `dev-tool`

Glossary `glossary`

Repo Card `repo-card`

Event Card `event`

Logo Wall `logo-wall`

Quote `quote`

Testimonial Wall `testimonial-wall`