Virtu

Your design system, encoded for agents.

Name a design system once in your repository. Every agent that works there reads it, makes pages, decks and emails with it, and runs Virtu's checks before it calls the work done.

  1. Install Virtu in your project

    It needs Node 22.18 or later.

    npm install --save-dev github:tchjhnsn/design-system-theory
  2. Choose the project's design system

    Pick an included system to start. virtu init writes virtu.config.json; a folder of assets can use another system with a rule in it.

    npx virtu init --system plain

    Want to own it? Copy the system into your repository and run npx virtu init --system design. See Plain

  3. Connect your agent

    The plugin adds Virtu's MCP server and the skill that tells the agent to read the project's system first.

    claude plugin marketplace add tchjhnsn/design-system-theory
    claude plugin install virtu@virtu
  4. Ask for the work

    Ask your agent for a page, a deck or an email. It calls virtu_project to learn the system, makes the asset with the system's names only, and checks it. You can run the same checks yourself:

    npx virtu build        # the CSS your app imports
    npx virtu audit        # names the system lacks, raw colours
    npx virtu check --asset deck decks/q4.html

    See what each asset type needs in Asset types.