Jared Bracci WordPress Theme

Built on the incredible Mozaik starter theme

This is the WordPress theme for the Jared Bracci website.

Development Guidelines

• Avoid committing the built theme to the project repository
• Avoid committing the wp-uploads directory to the project repository
• Avoid making changes directly to the built theme -- Always use the build process
• In production avoid uploading the theme development directory to a public server
• It is good practice to enable WP_DEBUG in your wp-config.php file, but only during development

Theme Development Process

Setup

1. Install WordPress and clear it of unnecessary default themes & plugins
2. Clone/Download the contents of this repository into a directory in your WordPress wp-content/themes directory (eg: "my-theme_dev") this will be your "dev theme"
3. Open the terminal and navigate to the dev theme, eg: cd wp-content/themes/<my-theme>_dev
4. (Note: The next steps require nodejs @5.0.0 and gulpjs @^3.9.0)
5. Run npm install to install all dev dependencies
6. Change the project.config.js file with your new theme's configuration
7. Run gulp build to generate the "built theme" for the first time
8. Log in to the admin and enable the built theme (Note: The dev theme is not a valid theme, that's fine! Don't delete it or try to enable it!)
9. Start Developing!

Development

1. Run gulp to begin the dev build process that uses libsass, browser-sync and webpack
2. Develop your theme in the /assets and /theme directories, the "built theme" will be generated by gulp
3. Optional stuff:
   • use npm install --save <module(s)> or bower install --save <module(s)> to easily manage js dependencies, then use var <module> = require('<module>'); or import <module> from '<module>'; anywhere in your js files you want to use them
   • explore the /library directory in the dev theme for anything useful to your project.

Production

1. Delete files you are not using from inside the /theme directory
2. Add a screenshot.png
3. Before deploying run gulp build to generate a production ready version of the built theme
4. Deploy the built theme directory, not the dev directory

License

This Theme is licensed under the MIT license see license.txt.