Granule - A WordPress Starter Theme.
Granule is the theme I use as the starter theme for all of my Pro Theme Design themes.
The theme was initially based on Darren Hoyts Gravy theme, but has evolved over many years of developing themes for wordpress.com. It now takes inspiration from _s and is a simple starting point for creating new WordPress themes.
Things to note:
- It is not a theme framework or a parent theme.
- The theme code does not care about backwards compatibility. There's no need since the theme is not a parent theme.
- Granule always supports the latest version of WordPress.
- WordPress coding standards should be followed. I do this locally using PHPCS, with the WordPress Coding Standards.
- Docblocks are used extensively. Eventually I want to auto generate documentation using these comments.
- Accessibility is baked in (following the WordPress.org standards). However I am sure it's not perfect and is something I am keen to improve - would love pull requests to help here :)
Below is a selection of the recent themes that Granule was used to create:
- Supports most major WordPress functionality (Custom header, Site Logo etc)
- Supports most Jetpack functionality (Featured Content, Infinite Scroll, Portfolios, Social Menus, Content Options - and more) - see jetpack.php for more.
- Follows the wordpress.com theme developer guidelines.
- Pure CSS dropdown menu (with a smattering of js for compatibility).
- SVG Icons
- SASS styles
- Boilerplate Customizer code
To use the theme as a starter theme I recommend checking out all of the files and then placing both the
granule directories into your
wp-content/themes folder. You can then either hack away on granule, or create a copy of the
granule folder and use that to create your themes. Either way you will need to do a case sensitive search and replace on all instances of the name
About the __sass Framework
Granule uses an external SASS library. This means the SASS is easily reusable - however it's entirely optional. If you don't want to use it then you can use your normal library/ process. This is one of the joys of using a starter theme.
If you want to use the Granule SASS library then I recommend the following process:
- Grab the Granule SASS library
- Place the Granule SASS library in the
wp-content/themesdirectory (Granule theme is setup to use this location)
Many of the library properties are stored in variables in the
__sass/lib/variables directory. These can be overriden in the