achttienvijftien/wp-turbo

Symfony UX Turbo for WordPress: the installable mu-plugin carrying the frontend (JS runtime, asset enqueue) on top of achttienvijftien/wp-turbo-bundle

dev-main 2026-06-16 18:07 UTC

Requires

• php: ^8.3
• achttienvijftien/wp-turbo-bundle: @dev
• composer/installers: ^1.8 || ^2.0

Requires (Dev)

• achttienvijftien/building-techniques: ^1.1
• dealerdirect/phpcodesniffer-composer-installer: ^0.7.2
• phpcompatibility/phpcompatibility-wp: *

GPL-3.0-or-later

• 1815

README

The default Turbo runtime carrier for achttienvijftien/wp-turbo-bundle: an mu-plugin that serves the Turbo JS (built via webpack, Drive disabled) and conditionally enqueues it.

It registers the wp-turbo-runtime script from its webpack manifest and enqueues it when the bundle announces a printed frame placeholder through the wp_turbo/frame_placeholder action — so the script only ships on pages that actually use Turbo. The carrier is replaceable: a theme that bundles its own Turbo runtime takes over by listening to the same action, and this package simply isn't installed.

WordPress projects require this package alongside the bundles:

• achttienvijftien/wp-turbo-bundle: the Symfony bundle (UX Turbo + TwigComponent on the 1815 service container, /_turbo routing, frame contexts and helpers)
• achttienvijftien/wp-twig-bundle: the generic Twig bridge (host-owned environment, Timber adapter)

The bundles register like native Symfony bundles via config/bundles.php (Flex recipes write those entries on composer require). This mu-plugin carries the frontend runtime: it loads its autoloader and registers the Turbo JS asset, listening on the wp_turbo/frame_placeholder contract.

Development

nvm use && pnpm install
pnpm build           # webpack → dist/ (committed; consumers don't build)