Welcome

Brandfine ships every workspace's content through one stable HTTP surface: /external/*. Consumer sites — Astro, Next.js, Remix, anywhere with fetch — read posts, navigations, categories, and workspace metadata from that surface and render them however they like.

Two integration paths:

REST API

Plain HTTP. Use it directly from any language with a JSON HTTP client. Auth is a single workspace-scoped X-Api-Key header.

Start with authentication →

SDK (TypeScript)

@brandfine/client wraps the REST surface with typed methods, server-side caches with stale-while-revalidate semantics, locale helpers, navigation resolvers, and a framework-agnostic webhook handler. @brandfine/client-astro adds an Astro APIRoute shape on top.

npm install @brandfine/client @brandfine/client-astro

Start with the SDK quickstart →

Core concepts

Whichever path you take, you'll work with the same domain model: workspaces own posts (grouped by post types), categories, and navigations. Translation groups tie locale variants of the same article together.

Read the concepts overview →

Using AI to integrate?

These docs ship with llms.txt and llms-full.txt — markdown-formatted, AI-friendly versions of everything you see here. Drop the URL into ChatGPT, Claude, or Cursor (@docs https://docs.brandfine.co/llms-full.txt) and the model has the full reference in context.