# Taggor documentation

> Write a component with your agent, publish it with the CLI, and put it on a site with one snippet.

> Esta página ainda não tem tradução para o português; este é o texto em inglês. (This page is not translated yet: the English text follows.)

Taggor is where AI agents publish components for websites. Your agent writes a component with the
`@taggor/component` SDK, the `taggor` CLI publishes it, and Taggor builds, hosts and versions it. Your
site loads every component it uses through one script tag, the snippet.

> **Test environment**
>
> These pages describe the Taggor staging environment used with design partners. It is not the
> product, nothing here is a promise, and the pages are not meant to be indexed.

## Follow the journey

1. [**CLI quickstart**](https://taggor.dev/docs/quickstart.md): download the CLI, sign in, create a first component, preview
   it, publish it to a test site.
2. [**The component contract**](https://taggor.dev/docs/contract.md): what `defineTaggorComponent` takes (props, events,
   slots, theming, data) and the limits the build enforces.
3. [**Forms and data**](https://taggor.dev/docs/forms-and-data.md) (also [in Portuguese](https://taggor.dev/docs/pt-br/forms-and-data.md)): collect
   what visitors submit, with anti-spam, consent, notifications, export and every error code of a failed
   submission.
4. [**Install the snippet**](https://taggor.dev/docs/snippet.md): paste one script tag, give each component a fallback, and
   what the visitor sees when something fails.

5. [**Agent quickstarts**](https://taggor.dev/docs/agents/claude-code.md): one page each for
   [Claude Code](https://taggor.dev/docs/agents/claude-code.md), [Codex](https://taggor.dev/docs/agents/codex.md) and [Cursor](https://taggor.dev/docs/agents/cursor.md).
6. [**Platform guides**](https://taggor.dev/docs/platforms.md): where to paste the snippet on WordPress, Shopify, Webflow, Wix,
   Framer, Squarespace, Google Tag Manager, plain HTML, React and Next.js. Also
   [fallback content](https://taggor.dev/docs/fallback.md) and [components in React, Vue and Angular](https://taggor.dev/docs/framework-interop.md).

## When something fails

Every error the API or the CLI prints, and every build diagnostic, has a page named by its code:
[API and CLI errors](https://taggor.dev/docs/errors.md) and [build diagnostics](https://taggor.dev/docs/diagnostics.md). The link in the
message leads to the same page, with what it means and what to do.

## Working with an agent

If you hand this to an agent that has no other context, give it the staging quickstart for agents at
`https://app-staging.taggor.dev/agents/`: it is plain text, lists only the commands to run and says
which steps belong to the person (creating the account, approving the sign-in, pasting the snippet).
