Agent guide

What a coding agent needs to install easeUI Pro components on your behalf.

Token

Every request against @easeui-pro needs an EASEUI_PRO_TOKEN somewhere in the environment. An agent installing a Pro component should treat a missing token as a stop condition and ask for it, rather than skip past it or invent one. See the installation guide for where that token comes from.

Discovery

Start at /llms.txt. It lists every component and block with a link to its markdown page, which says when to use it and gives the exact install command for each variant. Install names are per variant, such as balance-card, not per page, and /r lists them all. None of this needs a token; only fetching source does. An MCP server and an installable skill are on the way. For the free primitives Pro builds on, the free site's agent guide covers its MCP server and skill.

Endpoints

Endpoint	Purpose
/llms.txt	The catalog map, with every component and block, pricing, and a link to each page's markdown. Public
/llms-full.txt	The whole catalog in one file, with every variant and install command. Public
/components/{slug}.md	One component as markdown, with when to use it, its variants and exact install commands. Public
/blocks/{slug}.md	The same for a block. Public
/r	Every installable name, no source. Public
/r/{name}.json	shadcn install item with inline file content, requires the Authorization header

Manual flow

1. Find the variant's install name in its page's markdown, or in the public list at /r.
2. Fetch https://pro.easeui.dev/r/{name}.json with an Authorization: Bearer $EASEUI_PRO_TOKEN header.
3. Write every returned file to its declared path.
4. Install anything in registryDependencies, public @easeui items, from the free registry, no token needed for those.

shadcn flow

terminal

# Registered in components.json as @easeui-pro
npx shadcn@latest add @easeui-pro/balance-card

# Direct registry URL, still needs the Authorization header
curl -H "Authorization: Bearer $EASEUI_PRO_TOKEN" https://pro.easeui.dev/r/balance-card.json