Skip to content

Build for WordPress
using the tools
you love.

The tools you love. The CMS your clients know.
Start with the React adapter. More adapters are planned.

Start buildingExplore the docs
npx create-forgewp
ForgeWP, layer by layerTheme source passes through the current React adapter into the ForgeWP compiler, which processes them and produces a ready WordPress theme package. Hover over, focus, or tap the compiler to separate its five layers with spring motion; move away to reassemble. This is an illustrative workflow, not measured compilation progress.ReactAstroPlannedNext.jsPlannedWordPress themetheme.zipWORDPRESSTheme packageInteractive islandsRendered markupWordPress bindingsForgeWPTHE THEME COMPILERForgeWP
A FAMILIAR STACK.
A DIFFERENT DESTINATION. Theme source Adapters Compiler WordPress
01 / THE WORKFLOW

Your creative process.
A WordPress destination.

Author your design. Preview with local content.
Export a theme your clients can use in WordPress.

Build the layout in source, with reusable components and your own design decisions. React is the current adapter; more are planned.

Explore theme authoring

01 / Author
Hero.tsxREACT ADAPTER
export default function Hero() {
  return (
    <section>
      <h1>Make it yours.</h1>
    </section>
  )
}
Your components. Your design decisions.

An authoring example using the current React adapter.

02 / DEPLOYMENT

Two ways to ship.
One WordPress foundation.

Start with one React project and a local content workflow. Export a native theme, or build the frontend for separate hosting.

NATIVE THEME

Your React work. A native WordPress theme.

Turn your components into PHP templates, rendered markup and interactive islands. Install the ZIP on familiar WordPress hosting, where WordPress handles content, templates and plugins?with no Node.js server to run.

pnpm forgewp export
See how theme export works
DECOUPLED FRONTEND

Your frontend, directly connected to WordPress.

Host your frontend independently and load live WordPress content at runtime. Keep your React workflow and publish content without a frontend rebuild or rebuild webhook.

pnpm build
Plan your API connection
03 / THE FRAMEWORK

From content
to commerce.

The tools for the work beyond the layout.
Build the content model, editing experience, accounts
and storefront around your design.

Authentication & access

Build login, registration, account recovery and capability-based gates. In exported themes, WordPress owns the accounts and sessions.

@forgewp/authExplore authentication

WooCommerce storefronts

Build product views, reactive carts and checkout interfaces backed by WooCommerce. Keep commerce data and orders in your WordPress store.

@forgewp/woocommerceExplore commerce

Blocks & layout shells

Create native Gutenberg blocks and parent shells with allowed child blocks and layout constraints. Give editors structure they can compose within.

defineBlock() · InnerBlocksBuild with blocks

Intentional editability

Choose what stays in source and what clients can edit: named fields, inline block content or normal Gutenberg content areas. Combine them in one page.

defineEditable() · BlockAreaDesign the editing experience

A local CMS to build with

Preview content, menus and settings from local files. Develop the standard theme preview without a running WordPress installation or database.

cms/Meet the local CMS

Media optimization

Generate responsive WebP variants for eligible local images at export, with no upscaling. WordPress Media Library images use WordPress image sizes.

Sharp · responsive WebPExplore the image pipeline

Localization & translation

Extract translation keys, maintain local language catalogs and translate through configured providers. Add language switching to your theme.

i18n:extract · i18n:translateBuild for more languages

Selective hydration

Keep static content rendered and load JavaScript for interactive islands. Choose visibility, interaction or idle triggers, with optional near-visible preloading.

<Hydrate trigger="visible">Control interactivity

A CLI for the whole workflow

Scaffold blocks and pages, diagnose project issues, extract translations, inspect islands and validate your exported theme from the terminal.

make:block · doctor · exportBrowse the commands

Your WordPress plugins still belong.

Export a native theme that keeps WordPress hooks, plugins and admin workflows. Use core and plugin blocks through supported content areas alongside your own components.

Native WordPress integrationExplore WordPress integration
Start with what you need. Explore the rest as you build.Browse the documentation
YOUR NEXT GREAT BUILD STARTS HERE

Make something
worth forging.

Build your first theme

Your tools. WordPress at the finish line.