Skip to content
Agentic Experience Design Language Help Go to the portal

The pfdl command line

Download pfdl and use its main commands: lint, create, a11y, brand, theme and connect.

For developers2 min read

pfdl is the design language's command line, in one file. It checks code against the rules, starts new products, checks running pages in a browser, and connects your AI tools. It needs Node.js 20 or later.

Download it

Download two files from your portal into the same folder. Replace the address with your portal's:

curl -fsSO https://pfdl.example.com/downloads/pfdl.mjs
curl -fsSO https://pfdl.example.com/downloads/pfdl-data.json
node pfdl.mjs

With no command, it lists every command and option. pfdl.mjs alone runs lint, a11y and connect (with --portal); mcp, create, theme and brand also need pfdl-data.json beside it.

If you use the Claude Code plugin, pfdl is already on your path, so you can type pfdl lint src instead of node pfdl.mjs lint src. Products made with pfdl create keep a copy in tools/pfdl.mjs.

Main commands

lint

Checks code and copy against the design language's rules. Fix every error before you finish.

node pfdl.mjs lint src

--format json gives machine-readable output, --quiet shows errors only, and --max-warnings N fails when there are more warnings than N. Project settings go in pfdl.config.json. The PFDL check in CI card on the Connect page (/connect#ci) has the pipeline step.

create

Writes a new product repository, optionally starting from a template. See Start from a template.

node pfdl.mjs create acme-console --template <id>

a11y

Checks running pages in a browser: WCAG 2.2 A and AA, reflow, zoom, themes and the design language's rules on the rendered page. It needs playwright-core in the project. See Check a page and Accessibility checks in CI.

node pfdl.mjs a11y http://localhost:5173/

theme and brand

pfdl theme lists the design systems you can use; pfdl theme <id> switches the product to one. pfdl brand list lists them too, and pfdl brand pull brings one of your organisation's from the portal. See Use your design system.

connect

Connects, updates and signs in your AI tools, as Design Language Connect does. See Use Connect from the terminal.

mcp

Runs the MCP server on your computer. See The MCP server.

Signing in

Commands that read your organisation's design systems or templates use the sign-in from pfdl connect sign-in or Design Language Connect. In CI, set PFDL_TOKEN to an access token instead; it always wins.

If something goes wrong

If something goes wrong
What you seeWhat to do
pfdl-data.json not foundDownload pfdl-data.json into the same folder as pfdl.mjs.
a11y says it needs playwright-coreRun npm i -D playwright-core in the project.
Your organisation's design system isn't foundSign in with pfdl connect sign-in, or set PFDL_TOKEN.