Draft · How it works

From your agent's prompt to a component on your page

Your agent writes the component. Taggor builds it, versions it and delivers it through one snippet. Each step below is a real command or a visible result.

The path of a version

Your machineWrite and check
Taggor buildBuild in a sandbox, run the gates
TaggorA new immutable version
A channelStaging, then production
Taggor deliveryOne snippet, one loader
The visitor's browserThe component in a Shadow DOM

Fig. 1 · The path of one version, and where each step runs

Rollback: point the channel back at the previous version. Nothing is rebuilt, because the old version is still stored.

Step by step

Your agent writes the componentIt uses the Taggor SDK, in TypeScript. taggor init creates the project, and can install the rules your coding agent reads.
```
taggor init
```
Docs
Check it on your machinetaggor check runs the publish gates (types, size, security) locally, with no network.
```
taggor check
```
Docs
Taggor builds it and makes a versiontaggor publish sends the source to a build that runs apart from your machine, in a sandbox. When every gate passes, the result is a new immutable version.
```
taggor publish
```
Docs
Put one snippet on the sitetaggor sites snippet prints one script tag. Paste it once, then write the component's tag where it should appear.
```
taggor sites snippet
```
Docs
Promote, and go back if you need toA channel points at one version. Promote moves it; rollback points it back. The pages that carry the snippet follow without being edited.
```
taggor promote <component> --to productiontaggor rollback <component> --channel production
```
Docs
What visitors submit reaches youA component that collects data stores it for you, in the portal, with the consent the visitor gave when it is personal data. Export it when you want it.
```
taggor data export <collection>
```
Docs

How it works

From the first prompt to the visitor's page, step by step. Each one is a real command or a visible result.

Your machine
Your agent creates the component
It writes TypeScript against the Taggor SDK. taggor init starts the project and can install the rules your coding agent reads.
```
taggor init
```
Your machine
It checks its own work
Types, size and security gates run locally, with no network, before anything is sent.
```
taggor check
```
Taggor build
Taggor builds it and makes a version
The source is built in an isolated container and scanned. When every gate passes, the result is a new immutable version.
```
taggor publish
```
Your site
One snippet on the site
Paste one async script tag once. Then write the component's tag where it should appear.
```
taggor sites snippet
```
A channel
Promote when you are ready
A channel points at one version. Promoting moves it, and the sites that use the channel follow, with no edit to the page.
```
taggor promote <component> --to production
```
A channel
Go back in one command
Point the channel at the previous version. Nothing is rebuilt, because the old version is still stored.
```
taggor rollback <component> --channel production
```

Recipes

Things people ask their agent for. Each one is a prompt you can paste, a template to start from and what you end up with.

One component on many client sites

For An agency or freelancer with a handful of client sites.

Ask your agent

Write a quote-request form for my clients' sites. Each site sets its own heading and button color. Collect name, e-mail and the kind of project.

Starts from examples/contact-form

You get One component, published once. Each site carries one script tag, sets its own values without a new version, and every submission lands in the same place.

Lead capture for a landing page

For A site owner who wants contacts, with the visitor's consent on record.

Ask your agent

Make a contact form with name, e-mail and message, a consent checkbox that links to my privacy policy, and a thank-you message after sending.

Starts from examples/contact-form

You get A form that shows the consent box, keeps a proof of what the visitor accepted, and sends the submissions to your portal, ready to export.

A quiz or calculator for a campaign

For Whoever runs a campaign and wants people to play with an answer, not read a paragraph.

Ask your agent

Make a short quiz that ends in a recommendation by profile, with my colors. Store only the result, not the person.

Starts from examples/quiz-result

You get An interactive piece that matches the page's look through CSS variables. An anonymous collection records the results; you read them in the portal.

A poll or a feedback box

For A site that wants to hear from its visitors, without a survey tool.

Ask your agent

Add a one-question poll with three options, and a small feedback box underneath that asks how the visit went.

Starts from examples/quick-poll

You get Answers collected without personal data, listed per collection in the portal and exportable as CSV or NDJSON.

A launch with a countdown

For A team with a date to hit, and a page that should change when it arrives.

Ask your agent

Make a countdown to our launch date and time, in the visitor's time zone, that shows a short message when the time comes.

Starts from examples/launch-countdown

You get A countdown you can look at in a private preview first, then promote to production when you are ready, and take back if you change your mind.

The words on this page

Fig. 2 · Terms
Word	What it is
Component	What you publish: one HTML tag with its props.
Version	One build of a component. It never changes; a change is a new version.
Channel	A name, such as staging or production, that points at one version.
Site	A website that carries the snippet, with the list of domains where components may mount.
Snippet	One script tag per site. It loads a small loader that fetches only the components that site uses.

Try it with your agent

Paste the prompt into your coding agent, or start from the quickstart.

Paste this into your agent. It asks you before it signs in or pays.

Fetch https://taggor.dev/agent-setup/prompt.md and follow its instructions to set me up for Taggor. Ask me before you sign in, create an account, accept terms, pay for anything or type a secret.

Read the quickstart