bedrock editorconfig travis-ci Packagist

WordPress boilerplate with modern development tools, easier configuration, and an improved folder structure.


Build Status

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.


  • 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)
  • Enhanced security (separated web root and secure passwords with wp-password-bcrypt)

Use Trellis 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

See a complete working example in the repo.



  1. Clone the git repo - git clone
  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 (
    • WP_SITEURL - Full URL to WordPress including subdirectory (
    • AUTH_KEY, SECURE_AUTH_KEY, LOGGED_IN_KEY, NONCE_KEY, AUTH_SALT, SECURE_AUTH_SALT, LOGGED_IN_SALT, NONCE_SALT - Generate with wp-cli-dotenv-command or from the WordPress Salt Generator
  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


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

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

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


Bedrock documentation is available at


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


Keep track of development and community news.

Related Repositories



WordPress boilerplate with modern development tools, easier configuration, and an improved folder structure ...



Making awesome, one pebble at a time ...

Example project that uses Trellis, Bedrock, and Sage ...



Capistrano configs/integration for Bedrock ...



A minimalist boilerplate for Express apps. ...

Top Contributors

swalkinshaw retlehs austinpray yeah aaemnnosttv alexsomeoddpilot QWp6t fabschurt Foxaii starise BrandonShutter kucrut etcook fredriksundstrom meierjan rasmusbe louim dannyfischer benjibee chrisnx bendoh pcfreak30 emzo francescolaffi jonknapp nmec JulienMelissas KLVTZ liviucmg 8ig8


-   1.6.3 zip tar
-   1.6.2 zip tar
-   1.6.1 zip tar
-   1.6.0 zip tar
-   1.5.4 zip tar
-   1.5.3 zip tar
-   1.5.2 zip tar
-   1.5.1 zip tar
-   1.5.0 zip tar
-   1.4.7 zip tar
-   1.4.6 zip tar
-   1.4.5 zip tar
-   1.4.4 zip tar
-   1.4.3 zip tar
-   1.4.2 zip tar
-   1.4.1 zip tar
-   1.4.0 zip tar
-   1.3.7 zip tar
-   1.3.6 zip tar
-   1.3.5 zip tar
-   1.3.4 zip tar
-   1.3.3 zip tar
-   1.3.2 zip tar
-   1.3.1 zip tar
-   1.3.0 zip tar
-   1.2.7 zip tar
-   1.2.6 zip tar
-   1.2.5 zip tar
-   1.2.4 zip tar
-   1.2.3 zip tar