There are probably more theme boilerplates than actual themes available for bootstrapping your work on an amazing WordPress theme. And that is very much okay, because every developer, every agency has their own little flavors in how they like to do things.
That is the reason we made this theme boilerplate. We liked the work of so many other developers before us, but we never found the perfect boilerplate that fit our style of work. The result is this, a very opinionated theme boilerplate based on docker, grunt and less-css.
This boilerplate will give you all the tools you need to write, test and publish your theme, either for commercial clients or to publish the theme in the WordPress.org repository.
These steps will guide you through the setup process up until you can start writing functions, markup and styles for your theme.
For the sake of scope we will assume that you know the slug of your theme. Please make sure that the slug is unique to the system of the client, our projects and the WordPress.org theme repository.
We will also assume, that you have already configured your GitHub repository to your liking, downloaded the source of the boilerplate and uploaded it to your new repository. So let's get started:
- Search & Replace (case sensitive)
ekihhwith your new WordPress theme slug - Search & Replace (case sensitive)
_EKIHHwith your new WordPress theme slug in uppercase - Check success in
package.json,docker-compose.json&bin/install-wordpress.sh - Adjust
nameinpackage.jsonandTheme Nameinbuild/less/style.less
- Type
npm startinto the terminal to spin up the docker enviroment - Open
http://localhost/wp-adminand log in withadmin:password
- Create a patch release with the github action
- Check if the release has been created and uploaded in the GitHub release section
- Edit the
theme-README.mdwith the appropriate text about your theme - Delete (or rename) the
README.md(this file) - Rename the
theme-README.mdtoREADME.md - 🎉 Celebrate!