UISpec FAQs

Question 1

What is UISpec and what problem does it solve for AI agents?

Accepted Answer

UISpec is a Go binary that provides AI coding agents with deep, structured knowledge of UI component libraries. It solves the challenge of AI agents generating non-compliant code by enabling real-time validation against design system guidelines, catching errors before they're committed.

Question 2

How does UISpec integrate with AI coding agents?

Accepted Answer

UISpec runs as an MCP (Model Context Protocol) server, offering nine specialized tools for AI agents to query component details, prop schemas, design tokens, and composition guidelines. Agents can then use a `validate_page` tool to check their generated TSX code instantly.

Question 3

Can UISpec be used by developers as a standalone tool?

Accepted Answer

Yes, absolutely. UISpec functions as a powerful CLI tool for developers. You can use it to validate TSX files in CI/CD pipelines, inspect component details, and even auto-fix deterministic errors like incorrect import paths or invalid prop values during local development.

Question 4

Which component libraries does UISpec support, and can I use custom ones?

Accepted Answer

UISpec ships with a bundled shadcn/ui catalog, providing comprehensive prop schemas and rules out-of-the-box. Additionally, it supports any custom component library by allowing you to define your own `catalog.json` file based on its open JSON schema.

Question 5

What types of code violations can UISpec detect?

Accepted Answer

UISpec can detect a wide range of violations, including unknown components, missing imports, invalid or unknown prop values, missing required props, composition rule breaches (e.g., a sub-component used outside its parent), and usage of deprecated components or props.

UISpec

UISpec

Key Features

Use Cases

Key Features

Use Cases