imanzuk / bedrock

Modern WordPress stack that gets you started with the best development tools, practices, and project structure

Bedrock

Bedrock is a modern WordPress stack that helps you get started with the best development tools and project structure.

Much of the philosophy behind Bedrock is inspired by the Twelve-Factor App methodology including the WordPress specific version.

Features

• Better folder structure
• Dependency management with Composer
• Easy WordPress configuration with environment specific files
• Environment variables with Dotenv
• Autoloader for mu-plugins (use regular plugins as mu-plugins)

Use bedrock-ansible for additional features:

• Easy development environments with Vagrant
• Easy server provisioning with Ansible (Ubuntu 14.04, PHP 5.6 or HHVM, MariaDB)
• One-command deploys

Requirements

• PHP >= 5.4
• Composer - Install

Installation

1. Clone the git repo - git clone https://github.com/roots/bedrock.git
2. Run composer install
3. Copy .env.example to .env and update environment variables:

• DB_NAME - Database name
• DB_USER - Database user
• DB_PASSWORD - Database password
• DB_HOST - Database host
• WP_ENV - Set to environment (development, staging, production)
• WP_HOME - Full URL to WordPress home (http://example.com)
• WP_SITEURL - Full URL to WordPress including subdirectory (http://example.com/wp)

4. Add theme(s) in web/app/themes as you would for a normal WordPress site.
5. Set your site vhost document root to /path/to/site/web/ (/path/to/site/current/web/ if using deploys)
6. Access WP admin at http://example.com/wp/wp-admin

Deploys

There are two methods to deploy Bedrock sites out of the box:

• bedrock-ansible
• bedrock-capistrano

Any other deployment method can be used as well with one requirement:

composer install must be run as part of the deploy process.

Documentation

• Folder structure
• Configuration files
• Environment variables
• Composer
• wp-cron
• mu-plugins autoloader

Contributing

Contributions are welcome from everyone. We have contributing guidelines to help you get started.

Community

Keep track of development and community news.

• Participate on the Roots Discourse
• Follow @rootswp on Twitter
• Read and subscribe to the Roots Blog
• Subscribe to the Roots Newsletter