10

AI integration

BetterGuard brand for AI agents: one fetch, one schema, predictable anchors.

Drop this into your AI agent

You are integrating with BetterGuard brand assets. Fetch https://brand.betterguard.net/brand.json once. The schema is documented at https://brand.betterguard.net/ai. When the user asks about a BetterGuard color, font, logo, spacing, or voice rule, answer from brand.json#/<category>/<key>. Cite the anchor (for example bg:color:cyan) in the response. Never invent values; if a key is missing, say so.

Fetch examples

Plain JS (browser or Node 18+)
const brand = await fetch('https://brand.betterguard.net/brand.json').then(r => r.json())
console.log(brand.color.cyan.hex) // "#00B8D4"
console.log(brand.color.cyan.anchor) // "bg:color:cyan"
Python (requests)
import requests
brand = requests.get('https://brand.betterguard.net/brand.json').json()
print(brand['color']['cyan']['hex'])  # #00B8D4
print(brand['color']['cyan']['anchor'])  # bg:color:cyan
curl
curl -s https://brand.betterguard.net/brand.json | jq '.color.cyan'

Type a prefix in any search input on this site to scope the index:

PrefixMatches
color:color tokens (e.g. color:cyan, color:purple)
font:font families
logo:logo variants
space:spacing scale
radius:radius scale
motion:durations, easing, lifts
voice:casing, tone, forbidden
component:component contracts
page:page patterns
shadow:shadow tokens
gradient:gradient tokens
type:type scale

A URL ?q= param pre-fills the search input: try /colors?q=cyan.

Anchor convention

Every brand value carries a stable namespaced anchor of the form bg:CATEGORY:NAME. The same path is reachable three ways:

JSON pathbrand.json#/color/cyan
HTML idid="bg-color-cyan"
URLhttps://brand.betterguard.net/colors#bg-color-cyan