Getting Started With ZeroPress

Choose how you want to manage your content:

• Studio for writing and publishing in your browser.
• Markdown for a site maintained in Git.
• WordPress WXR for a quick trial with your existing content.

Each site starter includes a Deploy to Cloudflare button that creates a GitHub repository and deploys a sample site. You will need GitHub and Cloudflare accounts. Keep the default build command npm run build and deploy command npm run deploy. Cloudflare rebuilds the site when changes are pushed to the connected branch.

Publish With Studio

Use Studio Starter for the public site. Studio itself runs as a separate application.

1. If you do not have Studio yet, follow the Studio Quick Start.
2. Deploy Studio Starter using the button above.
3. Open zeropress-preview-data.json on your new repository’s main branch and copy its GitHub file URL.
4. In Studio, open Site Settings → Publishing, paste the URL, and use Create GitHub token to create a token for that repository with Contents: write permission. Enter the token, enable publishing, check the connection, and save. Set your public site URL in Studio’s site settings.
5. Create and publish a post in Studio. Open Publish, select Publish to GitHub, and confirm to replace the starter’s sample content.

Studio confirms the GitHub update. Check the Cloudflare build result to see when the public site has been updated. For local preview and theme changes, see the starter README.

Publish Markdown

Markdown Starter includes a documentation theme with navigation, search, and page outlines.

1. Deploy the starter using the button above.
2. Edit documents/index.md in your repository to change the home page.
3. Set your site title and public URL in documents/.zeropress/config.json.
4. Commit and push your changes to update the site.

The sample documents include navigation, frontmatter, and formatting examples. See the Build Pages guide for Markdown and configuration options, or the starter README for local preview commands.

Try WordPress Content

WXR Starter builds a static site from a WordPress export while continuing to use your WordPress media and comment API.

1. Deploy the starter using the button above. Choose a private repository if your export contains private information, such as commenters’ email addresses.
2. In WordPress, open Tools → Export, select All content, and download the WXR .xml file.
3. Replace wordpress-export.xml in your repository with that file, keeping the filename, then commit and push.

Images and links in post and page content keep their original URLs. Comments use the original WordPress REST API, so keep WordPress available and check the comment requirements. The XML export itself is not served by the public site.

Replace the export and push whenever you want to refresh the site. To move your content and media into Studio, follow WordPress Migration and publish to a separate Studio Starter repository.

Customize Or Build Locally

Each starter README covers local preview and theme changes. To create your own theme, use Customize a Theme. If you already generate Preview Data, see CLI Tools for direct builds.