html2wp / Guides

Guides: converting a website to WordPress

There are two ways to convert a website to WordPress. In the html2wp app for Mac and Windows you click through the steps and never need a terminal. With the plugin for Claude Code and Codex, you work in the terminal with an agent. Each way has a guide for a Lovable project and one for a design from Claude Design. Everything in them describes conversions we actually ran.

In the html2wp app

With the plugin for Claude Code and Codex

React input · 5 October 2026

Lovable to WordPress: a project converted into a real theme

An older Lovable project is a React app whose HTML holds nothing to convert until it is built and run in a real browser. Newer ones on TanStack Start render on the server, and the converter handles both. This is the longer route, with the extra step explained. It also has an example: you can open the original and the converted site and compare them.

Which guide is for you

Choose the app if you want to click and see every page next to the original, with no terminal. Choose the plugin if you already work in Claude Code or Codex. There you start the conversion with one sentence, right in the project folder.

If you built the site in Lovable, Bolt or v0, you have a React app. Its pages only come into being in the browser. So the conversion adds a step that builds the project and saves each route as finished HTML. The Lovable guide describes this step, and it works the same way for Bolt and v0.

If you have finished HTML files, for example an artifact from Claude or a hand-written site, there is nothing to build. Instead, the conversion starts straight with analysing the pages, and that is what the Claude Design guide describes.

Either way, the result is the same: a standalone WordPress theme in a ZIP file and a conversion report. Before you hand it to a client, you compare it with the original. You go page by page in the Compare tab of the desktop app. The converter does not accept the address of a live website. It always needs a folder or a ZIP with the files the site is built from.

The figures in the guides come from the output of real conversions. That includes the conversion time, the free tier limits and the widths at which pages are compared. So you can check them on your own project and compare them with what we describe. If the result on your site behaves differently from what a guide says, tell us through our form. Also mention which tool the site comes from.

The guides deliberately do not repeat the whole conversion process. The documentation for the app covers installing it, choosing a model and the difference between Flash and Full. It also says what leaves your computer. You can try it right away: the free tier converts three sites of up to five pages each, with no key and no sign-up.