Releases: CarlosEduJs/ogx
Releases · CarlosEduJs/ogx
@ogxjs/core core-v0.3.0
[@ogxjs/core 0.3.0] - 2026-01-05 "Universal Fonts"
Added
loadGoogleFont(fontName, weights)- Load any Google Font by name from CDNloadFontFromFile(path, options)- Load custom local fonts (next/font pattern)fontRegistry.registerGoogleFont(fontName, weights)- Register Google Fonts globallyfontRegistry.registerFontFromFile(path, options)- Register local fonts globally- Universal font loading system with CDN-based defaults (Bunny Fonts)
- Support for any Google Font without bundling
- Support for custom local fonts in Next.js projects
Changed4 "Universal Fonts"
Added
loadGoogleFont(fontName, weights)- Load any Google Font by name fro- BREAKING: Removed bundled Inter font files from package (~340KB reduction)
- BREAKING: Default font loading now uses CDN instead of bundled files
- Deprecated
loadInterFont()(useloadInterFromUrl()instead, will be removed in v1.0.0) - Deprecated
fontRegistry.registerInter()(useregisterInterFromUrl()instead, will be removed in v1.0.0) - Updated
ogx()andogxToSVG()to use CDN-based font loading by default - Updated build script to remove font file copying
- Package size reduced from ~620KB to ~576KB
- All tests updated to use CDN-based font loading
Notes
- Network dependency: Font loading now requires internet access on first render (fonts are cached after)
- Migration: Replace
loadInterFont()withloadInterFromUrl()for CDN loading - Migration: Use
loadGoogleFont()orloadFontFromFile()for custom fonts
@ogxjs/core core-v0.2.0.alpha-1
What's Changed
Other Changes
- feat(v0.2.0.alpha-1): OGX Turbo Version by @CarlosEduJs in #6
Full Changelog: core-v0.1.2...core-v0.2.0.alpha-1
@ogxjs/react react-v0.1.2
What's Changed
Other Changes
- Security Patch: prevent information disclosure [@ogxjs-react] by @CarlosEduJs in #2
Full Changelog: core-v0.1.1...react-v0.1.2
@ogxjs/next next-v0.1.1
What's Changed
Other Changes
- Security Patch: SSRF protection in Core + error sanitization in Next [@ogxjs-core, @ogxjs-next] by @CarlosEduJs in #3
Full Changelog: react-v0.1.2...next-v0.1.1
@ogxjs/core core-v0.1.2
What's Changed
Other Changes
- Security Patch: SSRF protection in Core + error sanitization in Next [@ogxjs-core, @ogxjs-next] by @CarlosEduJs in #3
Full Changelog: react-v0.1.2...core-v0.1.2
@ogxjs/core v0.1.1
What's Changed
Other Changes
- Security/patch ogxjs: URL validation, font timeout, parser checks & SHA-256 cache [@ogxjs-core] by @CarlosEduJs in #1
New Contributors
- @CarlosEduJs made their first contribution in #1
Full Changelog: react-v0.1.1...core-v0.1.1
OGX v0.1.0 - Initial Release
High-performance Open Graph image generation with Tailwind CSS
We're excited to announce the first public release of OGX! Generate dynamic OG images in 60ms with full Tailwind support, built-in caching, and seamless framework integration.
Packages
- @ogxjs/core@0.1.0 - Core rendering engine
- @ogxjs/next@0.1.0 - Next.js adapter
- @ogxjs/react@0.1.0 - React adapter with JSX support
Features
Core Engine
- ⚡ 60ms render time - Blazing fast image generation powered by Satori
- 🎨 Tailwind-first - Use Tailwind utility classes directly in your layouts
- 🔄 85x faster caching - Smart cache with 0.7ms cached renders
- 🎯 Fluent API - Build layouts with
stack(),row(),h1(),p(),badge(), etc. - 📐 Multiple formats - Generate PNG or SVG outputs
- 🌙 Dark mode - Built-in color scheme support
Presets
- Docs - Perfect for documentation sites
- Blog - Optimized for blog posts
- Social - Twitter/LinkedIn style cards
- Minimal - Clean, simple layouts
Framework Adapters
- Next.js -
ogxResponse()helper for App Router - React - JSX components with
twprop support - Universal - Works with any Node.js environment
Developer Experience
- TypeScript - Full type safety
- Comprehensive docs - Full documentation at ogx.dev
- 🎮 Live playground - Interactive editor with code generation
Quick Start
npm install @ogxjs/next @ogxjs/core// app/og/route.tsx
import { ogxResponse } from '@ogxjs/next';
export async function GET(req: Request) {
return ogxResponse({
preset: 'docs',
title: 'Hello OGX',
description: 'High-performance OG images',
colorScheme: 'dark',
}, req);
}📊 Performance
| Preset | First Render | Cached |
|---|---|---|
| Minimal | ~60ms | ~0.7ms |
| Docs | ~350ms | ~0.7ms |
| Social | ~693ms | ~0.7ms |
Links
- Documentation: https://ogx-three.vercel.app/docs
- npm: https://www.npmjs.com/package/@ogxjs/core
- GitHub: https://github.com/carlosedujs/ogx
- Playground: https://ogx.dev/playground
🙏 Acknowledgments
Built with:
- Satori - SVG generation
- @resvg/resvg-js - PNG conversion
- Tailwind CSS - Utility-first CSS
Full Changelog: https://github.com/carlosedujs/ogx/commits
@ogxjs/react v0.1.1 - Fixes
Bug Fixes
Type Safety Improvement
- Fixed: Replaced generic
Functiontype with specific typed function signature - Impact: Better type safety and resolves Biome linter warning
- File:
packages/react/src/to-ogx.ts
Technical Details
Before:
const resolved = (type as Function)(props);After:
const Component = type as (props: unknown) => React.ReactNode;
const resolved = Component(props);This change provides:
- More precise type checking
- Better IDE autocomplete
- Follows TypeScript best practices
- Eliminates linter warnings
Installation
npm install @ogxjs/react@0.1.1