A structured, modular WordPress framework powered by Symfony Dependency Injection.

BackTo Framework brings Clean Architecture, DDD patterns, and a compiled service container to WordPress theme and plugin development.

composer require backto/framework

Requirements: PHP 8.1+

// functions.php (theme) or plugin.php (plugin)
require_once __DIR__ . '/vendor/autoload.php';

$kernel = new MyTheme\Kernel('production', false);
$kernel->setTextDomain('my-theme');
$kernel->load();

// src/Kernel.php
namespace MyTheme;

use BackTo\Framework\Theme\ThemeKernel;

class Kernel extends ThemeKernel {}

See the Build a Theme tutorial for a complete walkthrough.

The documentation follows the Diataxis framework:

• Build a WordPress theme
• Build a WordPress plugin

• Register custom post types
• Register custom taxonomies
• Register block styles
• Register post meta fields
• Use the cache system
• Integrate SEO plugins

• Architecture overview
• Modules reference
• Contracts and interfaces
• Configuration reference

• Why a WordPress framework?
• Clean Architecture and DDD
• Vendor scoping with php-scoper

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.