Rob Ruiz on WP Rig and Modern Theme Development

WP Rig is a lightweight, opinionated starter toolkit for building WordPress themes that blends modern front-end tooling with WordPress best practices. It provides a structured starting point without imposing unfamiliar templating paradigms, and it includes build and linting tools so teams can write forward-looking CSS and JavaScript while staying aligned with WordPress standards.

What WP Rig provides

• A minimal starter theme and developer toolkit that integrates Composer and Node-based build tools. It automates common tasks like compiling CSS, bundling JavaScript, and running code standards checks so you can focus on theme design and functionality.
• Support for modern CSS workflows: you can write future-friendly CSS features today (for example, nesting) and have them compiled for current browsers using fast tooling such as esbuild or Lightning CSS.
• Linting and standards enforcement for PHP, JS, and CSS, including the WordPress PHP Coding Standards via PHPCS, helping teams catch issues early and maintain consistent quality.

Rob Ruiz and the project

Rob, originally a designer who moved into development, discovered WP Rig while evaluating theme frameworks and liked its small, WordPress-focused approach. After connecting with the prior maintainer, Rob took over stewardship of the project and led a major modernization (WP Rig v3), replacing older build tooling with faster alternatives and refining the workflow with contributors.

Who benefit from WP Rig

• Developers building custom, production-ready themes who want modern workflows and repeatable scaffolding.
• Designers and hobbyists learning how themes are constructed and gradually stepping into development.
• Agencies and teams that need shared opinions and guardrails to keep multiple projects consistent and maintainable.

Why teams choose it

• Minimal core: provides scaffolding and sensible defaults without adding foreign conventions that separate the theme from the WordPress ecosystem.
• Team alignment: built-in checks and automation reduce inconsistent practices, improve code quality, and make onboarding easier.
• Forward-looking tooling: modern CSS/JS pipelines let teams use recent language features while producing production-ready assets.

How you use it and the learning curve

WP Rig assumes local development on your machine rather than editing directly in the WP admin. That makes the toolkit approachable: you can start small by only touching CSS, or expand into full custom functionality as you learn. The project is meant to be educational and gradual — it helps people tinker in a safe environment and adopt correct practices over time. Rob emphasizes that coding provides precise, global control over site output, even though page builders can be useful for quick starts.

Requirements and workflow

To use WP Rig you typically need a local WordPress development environment (LocalWP, Docker-based setups, wp-env, etc.), Node.js for JS build tooling, and Composer for PHP dependencies. Development happens locally; the toolkit builds a distributable theme bundle, replacing WP Rig references with your theme name so the output is a clean, standalone theme ready for deployment or distribution.

Full Site Editing and blocks

WP Rig began in the classic theme space but now supports classic, hybrid/universal, and block-based themes. The toolkit includes commands to convert a starter into a block or hybrid theme. While Full Site Editing moves some design work into the admin UI and can reduce the need for hand-coded templates, there are times when theme-level blocks are appropriate (for example, bespoke navigation). A caution: bundling blocks into a theme can affect eligibility for the wordpress.org theme repository, so consider distribution plans before baking blocks into a shipped theme.

Education, guardrails, and documentation

A big part of WP Rig is learning: the project includes documentation, video tutorials, and examples to help developers understand modern front-end tooling within a WordPress context. Automated checks and linting help catch issues before you try to publish or share a theme, reducing rework and helping contributors learn good practices.

Project health and community

Since taking over maintenance, Rob rebuilt key parts of WP Rig to modernize performance and the developer experience. The contributor base has shrunk compared to the original launch, so maintenance currently relies on Rob plus occasional contributors. There is an official Discord server and a YouTube channel linked from the site, and the code and contribution guides are on GitHub. Rob invites more contributors to try v3, report issues, and help grow the project.

Why contribute or adopt WP Rig

Using or contributing to WP Rig helps you learn modern theme development while supporting an open-source tool that promotes WordPress best practices. It supports multiple theme paradigms, enforces standards, and is free to use. Whether you want a consistent toolkit for team projects or a learning platform to move from designer to developer, WP Rig is designed to make that transition smoother.

Where to find WP Rig and contact Rob

Project site and docs: wprig.io. The site links to Discord, YouTube, and GitHub. Rob is reachable via the Discord community listed on the site and on LinkedIn.

This episode of the Jukebox Podcast is a useful listen for anyone interested in theme development, modern WordPress tooling, or contributing to a focused, open-source starter theme and toolkit.