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.

Run your theme inside WordPress or host the frontend separately. Choose the approach that fits your project.

NATIVE THEME

Run inside WordPress.

Export PHP-backed templates, rendered markup and assets as an installable theme. WordPress serves the site and runs its plugins.

Source Theme .zip
pnpm forgewp exportExplore theme export
DECOUPLED FRONTEND

Host the frontend separately.

Build frontend assets for independent hosting and connect to WordPress through its API. WordPress continues to manage your content and backend.

Frontend WordPress API
pnpm build

Configure API access and authentication for your deployment. Plugin interfaces need their own frontend integration.

Understand separate frontends
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
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.