Convert WordPress sites into pixel-faithful Astro frontends packaged as Docker containers. The mirror engine crawls a live WordPress site, renders every page (Chromium when available), self-hosts all assets, and emits a deployable static Astro project; the scaffold engine rebuilds a clean headless frontend from the WP REST API. Generated sites deploy on xCloud (or any Docker host) and receive 1–5 second live content updates via the companion WordPress bridge plugin.

Install

npm install -g @speed.press/kit   # global `xch` command
# or run without installing:
npx @speed.press/kit inventory https://example.com

Requires Node >= 22.12 (generated projects build on Astro 7 / Vite 8).

Commands

Command	Does
`xch analyze <wp-url>`	Scan a WP site: post types, theme, plugins, permalinks, menus, taxonomies
`xch inventory <wp-url>`	List public post types + counts and a recommended batch plan
`xch mirror <wp-url>`	Exact-capture a site (pixel-faithful clone) into a deployable static Astro project
`xch mirror-verify`	Measure a mirrored project's fidelity vs the live site (`--visual` adds a screenshot diff)
`xch scaffold <wp-url>`	Generate an Astro project + Dockerfile from the WP REST API
`xch sync`	Pull latest WordPress content into local cache
`xch dependency-graph`	Build the manifest mapping content IDs to URLs (surgical updates)
`xch diff`	Visual diff between generated Astro pages and source WordPress
`xch verify`	Pre-deploy checks: routes, SEO meta, manifest integrity
`xch ai-scan <url>`	Score a site's AI & SEO agent-readiness via aiscan.site
`xch ai-ready`	Write `llms.txt` + an AI-friendly `robots.txt` into a generated project
`xch deploy`	Deploy to xCloud: provision domain, connect GitHub, install bridge plugin
`xch plugin-install`	Auto-install and configure the xCloud Headless Bridge WordPress plugin

Run xch <command> --help for all options.

Quickstart

xch inventory https://example.com
xch mirror https://example.com --out ./my-site --render chromium
xch mirror-verify --url https://example.com --project ./my-site

The output folder contains a full Astro project with a multi-stage Dockerfile — docker build and deploy.

Chromium rendering: mirror --render chromium (and mirror-verify --visual) need Playwright: npm i playwright && npx playwright install chromium. Without it, mirror falls back to server fetch.