# TagHost

> TagHost is a Cloudflare-native edge hosting platform and in-context visual CMS for React websites with sub-millisecond streaming HTML rewriting, zero cold starts, wholesale in-app domain registration, and zero vendor lock-in.

TagHost allows developers to build and deploy pure React 19 / Vite applications using standard Git pushes or CLI deploys, while allowing non-technical teammates and visual marketers to edit text, images, and content directly in-canvas. Dynamic content replacement occurs at the Cloudflare network edge via streaming `HTMLRewriter` in under 1ms without hitting backend origin servers.

## Quick Links

- [Official Documentation](https://docs.taghost.io): Complete guides, CLI references, and API documentation.
- [Full LLM Specification](https://taghost.io/llms-full.txt): Deep technical specification and reference manual formatted for LLM context windows.
- [Coding Agent Domain Playbook](https://taghost.io/domains/get-started.md): Agent playbook for discovering and comparing domains using the public TagHost Registrar API.
- [Public Availability Endpoint](https://api.taghost.io/domains/check): Bulk domain availability and pricing lookup (up to 200 domains per request).
- [Supported TLDs](https://api.taghost.io/tlds/supported): Current supported top-level domains (.com, .io, .dev, .app, .net, .co).

## Architecture Highlights

- **Edge Router (`apps/edge-router`)**: Cloudflare Workers router utilizing KV (`KV_DOMAINS`) for dynamic hostname resolution and R2 object storage (`taghost-assets`) for streaming static assets.
- **In-Context Visual CMS**: Uses standard `data-tag` HTML attributes (e.g. `<h1 data-tag="hero.title">Title</h1>`). The edge router replaces values on the fly via `HTMLRewriter` with zero build step delay and zero origin latency.
- **Zero Vendor Lock-In (`tag eject`)**: Run `npx @taghost/cli eject` at any time to run a Babel AST codemod that replaces `data-tag` attributes with static text values and outputs a standard standalone Vite/React project.
- **Dual-Path Domain Management**:
  - **Path A (BYOD)**: Connect external domains via CNAME to `cname.taghost.io` with automated Cloudflare for SaaS Universal SSL.
  - **Path B (Wholesale In-App Registrar)**: Programmatic search, wholesale purchase, ICANN WHOIS capture, and instant edge routing via Name.com API v4.
- **Anti-Honeypot Lead Capture**: Native `<TagForm name="contact">` component in `@taghost/react` with invisible honeypot shield, edge rate limiting, Resend transactional notifications, and webhook delivery.

## Developer CLI Commands

```bash
# Install CLI globally
npm install -g @taghost/cli

# Initialize a new React project configured for TagHost
tag init [project-name]

# Deploy current directory or build folder to production edge
tag deploy [--dir dist]

# Inspect and roll back to previous deployment in <10ms
tag rollback [deployment-id]

# Eject project to vanilla React with zero TagHost dependencies
tag eject
```

## Public Registrar API for Autonomous Coding Agents

Agents (Claude Code, Cursor, Codex CLI, Copilot, Windsurf, Gemini CLI) can search and price domains without authentication:

```bash
# Check supported extensions
curl -fsS https://api.taghost.io/tlds/supported

# Bulk check availability and retail/renewal pricing
curl -fsS https://api.taghost.io/domains/check \
  -H "Content-Type: application/json" \
  -d '{"domains": ["acmepreview.com", "acmepreview.dev", "acmepreview.io"]}'
```

## Pricing & Platform Economics

- **Free Tier ($0/mo)**: 1 Project, 1 Custom Domain, 100,000 monthly edge requests, Universal SSL, Visual Editor access, hard spending caps (zero surprise overages).
- **Starter Tier ($5/mo)**: 5 Projects, 3 Custom Domains, 2,000,000 monthly requests, Git PR preview deployments, custom branding removal.
- **Pro Tier ($10/mo)**: Unlimited Projects, 10 Custom Domains, 6,000,000 monthly requests, Edge D1 SQLite database, advanced analytics, priority support.