StaticPush by Quintaphon is a static site generator for WordPress. It exports your WordPress site to plain HTML and publishes it to GitHub (for Cloudflare Pages or any Git-based host), straight to Cloudflare Pages, or as a ZIP. After the first full push, every change you make in WordPress is pushed automatically, and only the pages that changed are sent.
Your visitors get a static site: fast, cheap to host and with nothing to hack. You keep editing in WordPress as usual.
Plugin site:
quintaphon.com/wordpress/staticpush
Documentation:
quintaphon.com/docs/wordpress/staticpush
Publish
- Destinations: GitHub (one-click "Connect GitHub", repository picker, create a repository), Cloudflare Pages Direct Upload, or a local folder and ZIP download.
- Automatic pushes: on publish, update, unpublish, delete, comments, terms and site-wide changes (menus, widgets, Customizer, theme). Edits made close together become one push.
- Push only what you need: pending changes, the full site, the current files, or specific pages (including the 404 page).
- Fast exports: several pages are fetched at once, directly from your own server.
- Safe by design: a push that would delete most of the static site is refused, and a login wall in front of WordPress stops the push instead of emptying the site.
- Scheduled posts: overdue scheduled posts are published and pushed, even though the WordPress install gets almost no visitors.
Export
- Full address or root-relative links, with every occurrence rewritten (including inline CSS, scripts and JSON).
- Finds everything through the WordPress database and by following links: posts, pages, custom post types, categories, tags, authors, pagination, feeds, sitemaps, robots.txt and ads.txt, and the 404 page.
- The theme's real 404 page, marked noindex.
- Feeds saved as feed.xml with a readable browser view, and old feed addresses redirected.
- Sitemaps with a readable browser view, and /sitemap.xml redirected to the sitemap index.
- Additional pages, files and folders; excluded addresses.
- Renamed posts and pages: the old address 301-redirects to the new one automatically (also for posts renamed earlier). Renamed categories and tags redirect to their new address; deleted ones to their parent category or the homepage.
- Cloudflare Pages
_redirects and _headers (including rules from the Redirection plugin and Yoast, Rank Math, AIOSEO and SEOPress sitemaps).
Features for the static site
- Site Search: a search index and an instant search overlay that takes over your theme's search forms. Fuzzy, typo-tolerant matching with Fuse.js, bundled and self-hosted.
- llms.txt for AI tools: a Markdown summary of the site at /llms.txt (llmstxt.org format) with your categories, pages and latest posts, rebuilt on every push.
- Related Posts: built into every post at export time, matched by shared tags or categories (topped up with the latest posts when few match), in the Jetpack Related Posts design, a simple grid or your own template.
- Forms: remove comment forms, or send POST forms to an external form service.
- HTML Clean-up: add a main landmark for accessibility when the theme has none; remove HTML comments, sourceURL markers, block editor and emoji styles, Dashicons, admin-bar CSS, Yoast schema, speculation rules and more; resource hints; HTML minify; your own removal rules.
- Stealth: Private WordPress mode hides the WordPress hostname from visitors and search engines while exports keep working; generator tags and WordPress API links can be removed.
Media Offload
Mirror your media library to a Cloudflare R2 bucket over the S3 API: resumable background sync with parallel uploads, pause and resume, automatic upload of new media, skip rules for sizes you don't need, and media links in exported pages pointed at your media domain. Image sizes kept out of R2 are replaced by the original in exported pages, so no image breaks.
Monitor
- Dashboard with live progress, push history and an activity log.
- Health Check: permalinks, loopback requests, background worker, direct fetch, WP-Cron, PHP, disk space, destination connection and more.
- WP-CLI:
wp static-push export [--no-deploy], wp static-push deploy, wp static-push status, wp static-push cancel.
- Install StaticPush by Quintaphon from Plugins > Add New (or upload the zip) and activate it.
- Go to Static Push > Destination, choose GitHub and click Connect GitHub. Enter the code shown on github.com and approve.
- Pick a repository, or click New to create a private one.
- Go to Export > Link rewriting, choose Full address and enter your public site address (for example https://www.example.com). Save.
- Click Push > Full site.
- In Cloudflare: Workers & Pages > Create > Pages > Connect to Git, pick the repository. Framework preset: None, build command: empty, output directory:
/.
From now on every change in WordPress becomes a commit, and Cloudflare Pages publishes it.
Recommended: move WordPress to its own hostname (for example
wp.example.com), point your public domain at the static host, and turn on
Stealth > Private WordPress.
Media on Cloudflare R2 (optional): create a bucket and an R2 API token with Object Read & Write, enter them under
Media Offload, click
Test connection, then
Sync media library now. Connect your media domain to the bucket (R2 > bucket > Settings > Custom Domains) and run a full push.
Keys can also live in wp-config.php instead of the database:
define( 'CFSP_GITHUB_TOKEN', 'github_pat_...' ); // fine-grained token for one repository
define( 'CFSP_API_TOKEN', '...' ); // Cloudflare Pages Direct Upload
define( 'CFSP_ACCOUNT_ID', '...' );
define( 'CFSP_R2_ACCESS_KEY', '...' ); // Media Offload
define( 'CFSP_R2_SECRET_KEY', '...' );
define( 'CFSP_BASIC_AUTH', 'user:password' ); // if WordPress is behind HTTP basic auth