Skip to content

Catalog feed

The whole catalog as one static JSON file: its shape, every field, a real entry and how to read it safely. Grid uses it to refresh its list of packs.

DocsUpdated 2026-11-12
Browse docs

Overview

/catalog.json is built with the site and served as a static file. It carries every catalog entry, checked against the same schema the site uses, so a reader can trust the shape.

Top-level fields
FieldTypeMeaning
version1The feed's format. We raise it when the shape changes in a way that would break an existing reader, so check it first.
countnumberHow many entries there are. It always equals the length of entries.
entriesarrayEvery catalog entry.

The response is cacheable for an hour (cache-control: max-age=3600), so a change can take up to an hour to reach a client that cached it.

An entry

Entry fields
FieldMeaning
idA kebab-case identifier, the same one used in URLs such as /catalog/<id>.
nameThe display name.
categoryOne of design-tool, whiteboard, agent, code, ui-library, motion, 3d, asset, planning, inspiration, utility.
urlThe tool's home page.
docsUrlIts documentation, when it has a separate one. Optional.
descriptionOne or two sentences, written by ExonUI.
pricingfree, open-source, freemium or paid.
platformsAny of macos, windows, linux and web.
tagsSearch words.
verifiedAtThe date (YYYY-MM-DD) we last checked the entry. Optional.
setupNotesThings a person should know before setting it up. Optional.
tryPromptA first request to try once it's connected. Optional.
packWhat ExonUI can act on. See below.

The pack

Pack fields
FieldMeaning
kindOne of mcp, library, asset, skill, bridge, link. See how ExonUI fits together.
transportFor servers: how to reach it. type is stdio, local-http, remote or direct-only.
healthCheckFor local servers: how to tell it's running. type is port, command or http. Optional.
classificationofficial, community-vetted or unverified.
defaultPolicyWhat Grid does with the pack's write tools by default: read, ask or write.
readOnlyToolsTools known to be read-only, for servers that don't say so themselves.
installFor libraries: the install command. Optional.
notesIdThe id of the pack's Grid Note, when it has one. Optional.

No secrets in the feed

Where a server needs a token, the feed names the environment variable and never holds a value.

A real entry

This is the entry for Lenis, as the feed serves it:

catalog.json (one entry)
{
  "id": "lenis",
  "name": "Lenis",
  "category": "motion",
  "url": "https://lenis.darkroom.engineering",
  "docsUrl": "https://github.com/darkroomengineering/lenis",
  "description": "Lightweight smooth-scroll library that keeps native scrolling behaviour. Pairs well with GSAP ScrollTrigger and scroll-linked animations.",
  "pricing": "open-source",
  "platforms": [
    "macos",
    "windows",
    "linux",
    "web"
  ],
  "tags": [
    "scroll",
    "smooth-scroll",
    "animation"
  ],
  "verifiedAt": "2026-11-16",
  "pack": {
    "kind": "library",
    "classification": "official",
    "defaultPolicy": "read",
    "readOnlyTools": [],
    "install": "npm install lenis",
    "notesId": "lenis"
  }
}

Reading it

read-catalog.ts
// ORIGIN is the site you're reading from, for example the origin of this page.
const response = await fetch(new URL("/catalog.json", ORIGIN));
const feed = await response.json();

if (feed.version !== 1) throw new Error(`Unsupported catalog feed version ${feed.version}`);
if (feed.count !== feed.entries.length) throw new Error("Incomplete catalog feed");

const libraries = feed.entries.filter((entry) => entry.pack.kind === "library");

Read the fields you need and ignore the rest, so a field added later doesn't break you.

Fonts feed (/api/fonts)

/api/fonts serves a cached list of open-source Google Fonts (sourced from Fontsource without requiring an API key on the client). Grid and the CLI use it to search families, weights, subsets and variable font support.

Query parameters
ParameterMeaning
qCase-insensitive search by font family or slug (?q=inter). Exact and prefix matches rank first.
categoryOne of sans-serif, serif, display, handwriting, monospace, icons.
subsetFilter by character subset such as latin, cyrillic or vietnamese.
variabletrue or false to filter variable fonts.
limitMaximum items per page (1–2000, default 50).
offsetZero-based pagination offset (0–5000, default 0).

The upstream directory is cached for 24 hours (stale-while-revalidate up to 7 days), with a compact fallback list of popular open-source fonts if the upstream API is temporarily unreachable.