MJS

WordPress to Astro Migration Kit

The runbooks and scripts I run to move client sites off WordPress and onto Astro and Cloudflare Pages: archive the old site, pull out its content, write the redirects, wire up the forms, and run the go-live checks. Point your agent at the folder and it knows where to start.

WordPress to Astro Migration Kit preview
01

The Runbooks

Seven markdown files covering the whole job: which path a site takes, the static and headless paths start to finish, SEO redirects so old URLs don't 404 when DNS flips, how the Astro site itself gets built (forms, Turnstile, Postmark, SEO, schema, images), a security headers standard, and go-live from archive to close-out.

02

The Scripts

13 Python tools the runbooks call: mirror the old site, screenshot every page and bind it into an archive PDF, turn a WordPress database backup into something you can query with no MySQL install, export a WooCommerce catalog, generate redirects, audit the new build before cutover, and set up Turnstile, Postmark, and Search Console in one command each.

03

A README Written for Your Agent

Drop the folder in, tell your agent which site you're moving, and it reads which runbook applies, what order to run things in, and what goes in your .env. The rules that keep it from doing damage (archive first, never flip DNS on its own) are spelled out at the top.

04

The Notes That Save You Time

Every runbook carries the failure modes that already bit a real migration, with the fix attached: sitemaps that list a fraction of the pages, custom post types the REST API hides, backups that were failing silently.

Fill out the form and I'll send it to you.

You'll get it by email, and you'll get my newsletter too. Unsubscribe anytime.