A Modern WordPress Starter Theme for savvy Developers

Prerequisites

This theme relies on NPM and Composer in order to load dependencies and packages. Webpack should always be running and watching during the development process, in order to properly compile and update files.

• Install Composer
• Install Node
• Install mkcert. You need mkcert installed globally to create the ssl certs for browsersync to work (mac OS)

Installation

• Move the .env.example to your WordPress root directory, rename it as .env, and setup your website variables (make sure to set the WP_HOME var as insecure http in order to ssl certs working properly)
• Move the wp-config.sample.php to your WordPress root directory and rename it as wp-config.php, to replace the default one
• Open a Terminal window on the location of the theme folder
• Execute composer install
• Execute npm install

Webpack

AWPS uses Laravel Mix for assets management. Check the official documentation for advanced options

• Edit the webpack.mix.js in the root directory of your theme to set your localhost URL and customize your assets
• Edit the package.json "config" entry to match your local host and define your ssl certs folder
• npm makecerts to create the ssl certs for browsersync with LiveReload
• npm run dev to start browserSync with LiveReload and proxy to your custom URL
• npm run prod to compile the assets for production

Features

• Bult-in webpack.mix.js for fast development and compiling.
• OOP PHP, and namespaces with PSR4 autoload.
• Customizer ready with boilerplate and example classes.
• Gutenberg ready with boilerplate and example blocks.
• ES6 Javascript syntax ready.
• Compatible with JetPack, WooCommerce, ACF PRO, and all the most famous plugins.
• Built-in FlexBox Responsive Grid.
• Modular, Components based file structure.

License

GPLv3