colophonjs.dev is built with Starlight, hosted on Amazon CloudFront.
| Technology | Version | First seen |
|---|---|---|
| CMS & Site Builders1 | ||
| – | 9 Nov 2026 | |
| JavaScript Frameworks & Libraries2 | ||
| 7.2.2 | 9 Nov 2026 | |
| – | 9 Nov 2026 | |
| CDN & Hosting3 | ||
| – | 9 Nov 2026 | |
Registration from the registry's RDAP record, the certificate the site serves, and its rank in public traffic lists.
The crew hasn’t read this site’s colors yet. We read a palette when we capture a site’s screenshot, busiest sites first. Meanwhile, browse palettes from other sites.
Counted from every stack change we've recorded: of the sites we watched running one of this site's tools, how many went on to add another. A pattern across sites, not a forecast for this one.
ns-249.awsdns-31.comns-700.awsdns-23.netns-1916.awsdns-47.co.ukns-1520.awsdns-62.orggoogle-site-verification=fMQtrAKFhsklP0bqvRmZbdrPStJqFwfLl-DiTiLT7Ng# https://colophonjs.dev/robots.txt User-agent: * Allow: / # Pagefind's search index. The browser fetches it with JavaScript, so blocking # it here costs the site nothing and keeps a few hundred JSON fragments of # chopped-up page text out of the index. Disallow: /pagefind/ Sitemap: https://colophonjs.dev/sitemap-index.xml
# Colophon
> Colophon generates social meta images, the Open Graph and share-card images a platform shows when someone posts a link to a site. It reads image props from a post's frontmatter and renders branded PNGs at the sizes the site needs. It is an npm package, @kensio/colophon, usable as a CLI or from Node.
Every page below is also available as one file: https://colophonjs.dev/llms-full.txt (about 174KB)
## Start here
- [Getting started](https://colophonjs.dev/getting-started/): Colophon reads image props from a post's frontmatter and renders a PNG for each output size you have configured.
## Guides
- [The command line](https://colophonjs.dev/cli/): text colophon [contentDir] [options] Render the images for a content tree colophon init [contentDir] Write a starter config module colophon preview <file>...
- [Templates](https://colophonjs.dev/templates/): A template is a layout. Frontmatter picks one by name, so different posts on the same site can produce different kinds of image from the same config.
- [The code template](https://colophonjs.dev/code-template/): The code template renders a syntax-highlighted snippet on a rounded panel over the background. The colours come from a real VS Code theme, by way of Shiki.
- [Astro](https://colophonjs.dev/astro/): There are two halves to this: an integration that renders the images during the build, and a component that emits the tags for the route being rendered.
- [The browser-safe core](https://colophonjs.dev/core/): buildSvg builds a string: it takes props, a config and a size, and returns an SVG document.
- [The layout toolkit](https://colophonjs.dev/layout/): Writing a template means returning a string of SVG, which is manageable by hand for a heading and a rectangle, and much less so once the layout has a photo...
- [Rebuilds](https://colophonjs.dev/rebuilds/): Every image Colophon writes carries a stamp: a hash of the props, the config and the output size it was rendered from, stored inside the image file itself.
- [Programmatic use](https://colophonjs.dev/programmatic-use/): The CLI is a thin wrapper over two entry points. Use them directly when a project needs to drive generation itself.
- [Upgrading](https://colophonjs.dev/upgrading/): Text is measured against the fonts a build actually renders with, instead of being estimated from a per-template fudge factor.
## Configuration
- [Configuration](https://colophonjs.dev/configuration/): Colophon is configured with a module whose default export is a ColophonConfig.
- [Frontmatter](https://colophonjs.dev/configuration/frontmatter/): By default Colophon reads a meta_img_props object from a post's frontmatter, takes the template name from a template field within it, and reads the post slug...
- [Fonts](https://colophonjs.dev/configuration/fonts/): Colophon ships with two typefaces and uses them out of the box, so a project that configures nothing still renders the same image on a laptop, in CI and in a...
- [Themes and background treatments](https://colophonjs.dev/configuration/themes/): A theme is a named look, made up of a palette, a background and a texture over it. Naming one is the shortest config a project can write.
- [Rasteriser](https://colophonjs.dev/configuration/rasteriser/): Colophon builds an SVG document per image and then turns it into bytes. That second step is resvg by default, and rasteriser is how you replace it.
- [Output formats](https://colophonjs.dev/configuration/formats/): Colophon writes PNG unless you say otherwise.
- [File size](https://colophonjs.dev/configuration/compression/): This page is about PNG, which is what a build writes unless format says otherwise.
- [Logos, avatars and photographs](https://colophonjs.dev/configuration/images/): There are four places an image can go into a generated one: a logo in the corner, an author's photo beside the footer, the post's own photograph, and a picture...
- [Output sizes and filenames](https://colophonjs.dev/configuration/sizes/): Each output size is a named { name, width, height }.
- [Per-size config](https://colophonjs.dev/configuration/per-size-config/): Some settings only make sense per size. code.minFontScale is the clearest case: a 1:1 square and a 1.91:1 landscape have very different amounts of vertical...
- [Placement](https://colophonjs.dev/configuration/placement/): An output path says where the bytes go and nothing about how anyone reaches them, which leaves a site to rebuild that mapping in its own templates from...
- [Manifest](https://colophonjs.dev/configuration/manifest/): A build that only writes images leaves the site to work out for itself what was generated, where it lives and how big it is, which usually means globbing for...
- [Social meta tags](https://colophonjs.dev/configuration/meta-tags/): Generating the image is only half the job, since the site still has to write the tags that point at it.
- [One-off images](https://colophonjs.dev/configuration/extra-images/): Not every image belongs to a post.
- [Cover images](https://colophonjs.dev/configuration/cover-images/): A cover is the header image at the top of a profile: the strip behind your name on X, LinkedIn, Bluesky or a YouTube channel.
- [Warnings](https://colophonjs.dev/configuration/warnings/): Some inputs cannot be honoured exactly.
## Optional
- [Playground](https://colophonjs.dev/playground/): build a config and render an image in the browser
- [npm package](https://www.npmjs.com/package/@kensio/colophon): install and version history
- [Source repository](https://github.com/KensioSoftware/colophon): source, issues and the docs these pages are built from
| – |
| 9 Nov 2026 |
| – | 9 Nov 2026 |