WordPress Bedrock + Docker + Vite 5

Block Theme (FSE) boilerplate with interactive setup,
ACF Blocks v3, TypeScript, SCSS, and remote sync.

Get started → node setup.js

■ THE PROBLEM

Shopify developers run shopify theme dev and get instant local-to-server sync, hot reload, and a modern stack out of the box. WordPress developers? We get FTP clients from 2005, manual uploads, and prayer-based deployments.

This boilerplate closes that gap. Edit your theme locally with Vite HMR, auto-sync to your staging server via rsync or FTP, and develop with a real stack: TypeScript, SCSS, Docker, Bedrock, ACF Blocks. One node setup.js and you're running.

💀 Classic WP workflow

  • Edit via FTP client or cpanel editor
  • No HMR, manual refresh
  • Vanilla CSS / jQuery spaghetti
  • No version control structure
  • "It works on my machine"

⚡ With this boilerplate

  • Edit locally, auto-sync to server
  • Vite HMR — instant CSS updates
  • TypeScript + SCSS + BEM
  • Bedrock + Docker + Composer
  • Works everywhere, same config

Think shopify theme dev, but for WordPress.
And yes — you can sync to production if you're brave enough.

■ FEATURES

Everything you need, nothing you don't.

🐳

Docker Stack

PHP 8.2-fpm, Nginx, MariaDB 11, MailHog, phpMyAdmin. One command to start.

Vite 5 HMR

Instant CSS updates. Zero-config hot module replacement with ViteHelper.php bridge.

ACF Blocks v3

Custom blocks with block.json + render.php. Example CTA block included.

🛰

Remote Sync

Powered by wp-dev-sync CLI. SSH (rsync) or FTP (lftp). Edit locally, auto-sync to any server.

📝

TypeScript

Strict mode, path aliases, component init pattern. Type-safe from day one.

🎨

SCSS + BEM

Media query mixins, design tokens, CSS variables. Mobile-first with modern CSS.

■ DEV MODES

Choose your workflow. The setup configures everything.

🐳

Docker

Full local stack

PHP-FPM, Nginx, MariaDB, MailHog, phpMyAdmin. Isolated, reproducible, zero-config.

🚀

Remote Sync

SSH (rsync) • FTP (lftp)

Edit locally, auto-sync to your server. Watch mode with OS-native file watchers.

Both

Docker + Remote Sync

Develop locally with Docker, push to staging/production with wp-dev-sync.

■ INTERACTIVE SETUP

One command. Fully configured project.

SETUP.JS

■ QUICK START

Three commands to launch.

# Clone the boilerplate
git clone https://github.com/reandimo/wordpress-vite-boilerplate.git my-project

# Enter the project
cd my-project

# Run the interactive setup
node setup.js

■ TECH STACK

Modern tools, battle-tested architecture.

WordPress 6.9 Bedrock PHP 8.2 Vite 5 TypeScript SCSS Docker Nginx MariaDB 11 ACF Pro FSE / Block Theme wp-dev-sync rsync lftp Composer PSR-4 BEM

⚠ WORK IN PROGRESS

This project is under active development. Features may change, break, or evolve. That's where you come in.

Found a bug? Have an idea? Want to improve something?
Open an issue — all contributions and feedback are welcome.