Nathan Wrigley interviews Rob Ruiz about WP Rig, a free open‑source toolkit and starter theme for modern WordPress theme development. Rob, a designer‑turned‑developer who now works as an architect at an agency, became WP Rig’s maintainer after discovering the project, joining a maintainer call, and taking it on when the previous maintainer stepped back.
What WP Rig is
– WP Rig is a minimal, opinionated theme development framework and starter theme that combines PHP, Composer packages, Node tooling, and build tools to provide a modern developer experience.
– It’s like a contemporary underscores-style starter but with integrated tooling to enforce WordPress best practices, automate CSS/JS processing, and speed up development.
– It targets people who want more control and want to learn theme development: from experienced developers to designers who want to start tinkering with code.
Why Rob chose WP Rig
– He appreciated its minimal, WordPress‑native approach (no foreign templating languages) and good alignment with Core WordPress.
– WP Rig supports modern CSS workflows (PostCSS originally, now more modern tooling) so developers can use future CSS features today, compiled back for current browser support.
– It provides guardrails: linters and checks that help teams keep consistent coding standards, useful for agencies and multi‑developer projects.
Who it’s for and the learning curve
– WP Rig assumes you’ll work on your local machine, not in the remote WP admin. You can start small—edit a few CSS rules—and gradually learn more.
– Required tools: Node.js, Composer, and a local development environment (Local WP, wp-env/Docker, WordPress Studio, etc.).
– Developers new to local tooling can take it step by step; WP Rig lets you focus on the parts you want to learn first (e.g., CSS) without forcing everything at once.
Workflow highlights
– WP Rig uses build tooling to process CSS, TypeScript/JS, and other assets on your computer.
– When you’re ready to ship, the bundle process generates a distributable theme: it replaces WP Rig references with your theme’s name so the shipped theme looks and behaves like any other theme.
– This makes it suitable for client projects, custom themes, or commercial distribution.
Full Site Editing, blocks, and paradigms
– WP Rig started in the classic PHP template paradigm but has evolved to support Full Site Editing (FSE), block themes, and hybrid approaches.
– It includes CLI commands to convert a project between classic, block, and universal/hybrid paradigms, enabling developers to choose the workflow that fits their project.
– WP Rig now supports block authoring at the theme level. Baking blocks into a theme disqualifies the theme from wordpress.org, so that approach fits private client projects or commercial themes rather than repo contributions.
– Rob argues theme‑level control can be valuable (for example, custom navigation blocks that are tightly coupled to a theme’s design).
Education and standards
– A key aim of WP Rig is educational: to help people learn how themes and the web stack work (HTML, CSS, JS) and to encourage contributors to the broader WordPress ecosystem.
– WP Rig integrates code quality tools—like PHPCS and the WordPress Coding Standards (WPCS)—so developers can check their code against WordPress standards before submitting themes or publishing.
– These guardrails reduce friction for contributors and make theme code more robust whether for the wordpress.org repo or commercial use.
Community and maintenance
– After Rob adopted the project he overhauled it, producing a major v3 release that replaced older tooling (like Gulp) with faster, leaner modern build tools (esbuild, Lightning CSS, etc.).
– The contributor base is smaller than it once was; much of the current work is driven by Rob with occasional contributors. Rob aims to grow the community again and invites contributions via GitHub.
– Resources: documentation, video tutorials, and a Discord community are available on the WP Rig site.
Getting started and resources
– Visit wprig.io for docs, learn materials, videos, and links to contribute.
– Pre requisites: Node, Composer, and a local WordPress environment.
– Rob is reachable via the WP Rig Discord and on LinkedIn for questions or guidance.
Closing
– WP Rig provides a modern, minimal toolkit for building themes, suitable for learning and professional workflows, and has been updated to support classic, hybrid, and block paradigms.
– Rob encourages people to explore WP Rig, use its educational resources, and contribute to the project and WordPress.
For more information and links: wprig.io.