Private guides
A private guide is your brand in the same shape as Astron's public guides: tokens, typefaces and written rules. Inside your workspace, agents prefer it over the public library.
Available on Pro and Team. On Team, private guides are shared with every seat. Compare plans.
File format
A guide is one astron.guide.json file. Rules are plain sentences; write them the way you would brief a new designer.
{
"slug": "ledgerly",
"title": "Ledgerly",
"extends": "editorial-saas",
"tokens": {
"ink": "#0b0b0c",
"accent": "#f2542d",
"radius": [12, 16, 20],
"font": { "sans": "Geist", "mono": "Geist Mono" }
},
"rules": [
"Amounts always use tabular figures and a currency code.",
"Destructive actions are text buttons, never filled red.",
"Empty states show the single action that fills them."
]
}Upload
From the dashboard, open Guides and drop the file in. Or use the CLI in CI so the guide tracks your repository:
npx @astron/mcp guide push ./astron.guide.jsonHow agents choose
- With a private guide in the workspace,
get_design_guidereturns it for every kind of screen. - Rules from
extendsapply unless your guide overrides them. - Pass
guideexplicitly to use a public guide for one call.