@better-og/core

The core package for the better-og workspace.

It contains the runtime-agnostic helpers used by every adapter:

• aspect-ratio presets (STANDARD, SQUARE, PORTRAIT, INSTAGRAM)
• getOgContext(request) with Twitter safe-area hints
• locale-aware font loading via getFontsForRequest()
• resolveFontSetup() for loaded fonts plus resolved family names
• shared adapter helpers such as applyStableCacheHeaders()

Install

pnpm add @better-og/core

Usage

import { getOgContext, resolveFontSetup } from "@better-og/core";

const ogContext = getOgContext(request);

const fontSetup = await resolveFontSetup({
  fallbackFontLocales: ["ja", "ar"],
  fonts: customFonts,
});

Notes

• Twitter requests expose safeArea.bottom = 44
• Built-in locale fallbacks use Noto Sans variants
• Adapter packages live alongside this package in the workspace