Getting started

What Onefold is, and what it is not

Onefold reads the design system you already have, measures whether an AI agent can use it correctly, and makes that understanding available to agents.

Onefold is a layer above your design system. It connects to the places the system already lives, builds one structured understanding of it, and measures whether an AI coding agent can use it correctly. It does not hold your components, and it does not ask you to move anything.

The problem it addresses#

Most teams have the pieces. There is a Figma library, a component package, a Storybook, and some documentation. What no team has is a single representation that joins them: which Figma component became which React component, which props exist, which combinations are valid, when a component should not be used.

A person can reconstruct that by asking a colleague. An agent cannot. It reads what it can find, pattern matches on the closest example, and produces something that compiles, passes review at a glance, and quietly ignores the system.

What it does#

  1. Connects sources. GitHub repositories through a read only GitHub App, Figma libraries, and the Storybook configuration inside the repository.
  2. Discovers deterministically. Real parsers walk the code and extract components, props, variants, tokens, stories and documentation. Your repository is not pasted into a model.
  3. Reconciles design with code. Figma components and variables are matched to their implementations, and every match keeps the evidence behind it and a confidence value.
  4. Scores AI Readiness. Eight weighted dimensions, each one backed by the findings that produced it. See how the score is calculated.
  5. Exposes the result to agents. Generated context you commit to your repository first, and an MCP server later.

What it is not#

  • Not a component library. Onefold ships no components and asks you to adopt none.
  • Not a documentation site. It reads the documentation you have and tells you what is missing from it. It does not become the place you write it.
  • Not a Figma or Storybook replacement. Both stay exactly where they are.
  • Not a linter. A lint rule reads one file against one rule. Onefold reads a system against how an agent will consume it.
  • Not an AI that rewrites your components. Findings come with evidence and stay findings. What you change is your decision.

What exists today#

Onefold is in development and has not been released. There is no signup, no pricing, and nothing to connect a repository to yet. The order of work is GitHub analysis and the first readiness report, then Figma reconciliation, then MCP.

If you want to be there when the first report can be run against a real repository, request early access. What that involves is described in early access.

Last updated

Related

Something wrong, missing or out of date in this article? Email onefold@pitsch.me and it gets fixed. Or start at the help center.