Quick Start

Install

npm install @ai-by-design/primitiv

or

bun add @ai-by-design/primitiv

1. Initialize your project

Run init in your project root:

bunx @ai-by-design/primitiv init

Primitiv detects your framework, TypeScript, Tailwind, Figma token files, and Storybook automatically and generates a tailored primitiv.config.js.

2. Build your contract

bunx @ai-by-design/primitiv build

3. Start the MCP server

bunx @ai-by-design/primitiv serve

primitiv init writes a .mcp.json to your project root automatically, so Cursor, Claude Code, and any other MCP-compatible tool will pick up the server without manual config.

From this point, every agent that builds UI in your codebase calls get_design_context first and gets your resolved design contract back.