@speed.press/kit
v1.8.0
Published
Convert WordPress sites into pixel-faithful Astro frontends
Maintainers
Readme
@speed.press/kit
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.comRequires 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-siteThe output folder contains a full Astro project with a multi-stage Dockerfile — docker build and deploy.
Chromium rendering:
mirror --render chromium(andmirror-verify --visual) need Playwright:npm i playwright && npx playwright install chromium. Without it,mirrorfalls back to server fetch.
Links
- Docs, skill, and bridge plugin: github.com/xCloudDev/xcloud-headless
- Hosted flow (convert from the browser, no CLI): Speed.Press (platform repo)
MIT
