PHPackages tombroucke/bedrock - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. tombroucke/bedrock ActiveProject[Framework](/categories/framework) tombroucke/bedrock ================== WordPress boilerplate with Composer, easier configuration, and an improved folder structure 1.21.0(3y ago)0111[5 PRs](https://github.com/tombroucke/bedrock/pulls)MITTypeScriptPHP >=7.4CI passing Since Dec 18Pushed 3mo agoCompare [ Source](https://github.com/tombroucke/bedrock)[ Packagist](https://packagist.org/packages/tombroucke/bedrock)[ Docs](https://roots.io/bedrock/)[ RSS](/packages/tombroucke-bedrock/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (38)Versions (123)Used By (0) [ ![Bedrock](https://camo.githubusercontent.com/f2375853612cf550307d648da4899ad98dfa9c55e6654b7391e3ea9defcbfe41/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f6c6f676f2d626564726f636b2e737667) ](https://roots.io/bedrock/) [ ![MIT License](https://camo.githubusercontent.com/ff1cc793999dedad378f0b39e20c661c4aa238f26481ed456f5b9b9da085592c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f726f6f74732f626564726f636b3f636f6c6f723d253233353235646463267374796c653d666c61742d737175617265) ](LICENSE.md) [ ![Packagist](https://camo.githubusercontent.com/43c0b95ecb968e1f4642fe19468e20caec6e20acc273b308b293b7efbd202ac6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726f6f74732f626564726f636b2e7376673f7374796c653d666c61742d737175617265) ](https://packagist.org/packages/roots/bedrock) [ ![Build Status](https://camo.githubusercontent.com/86d444ed02f44ba2a8892e0936d397c58b78f3cbc0061c7aa3be047f27f607b5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f726f6f74732f626564726f636b2f43493f7374796c653d666c61742d737175617265) ](https://github.com/roots/bedrock/actions/workflows/ci.yml) [ ![Follow Roots](https://camo.githubusercontent.com/2b8273856233cb73467f46b7b730c721f9b4d3b1751394e4127246f862720f34/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f666f6c6c6f772f726f6f747377702e7376673f7374796c653d666c61742d73717561726526636f6c6f723d316461316632) ](https://twitter.com/rootswp) **A modern WordPress stack** [**`Website`**](https://roots.io/) [**`Documentation`**](https://docs.roots.io/bedrock/master/installation/) [**`Releases`**](https://github.com/roots/bedrock/releases) [**`Support`**](https://discourse.roots.io/) Sponsors -------- [](#sponsors) **Bedrock** is an open source project and completely free to use. However, the amount of effort needed to maintain and develop new features and products within the Roots ecosystem is not sustainable without proper financial backing. If you have the capability, please consider [sponsoring Roots](https://github.com/sponsors/roots). [![Sponsor Roots](https://camo.githubusercontent.com/87ae273e72964c9391e12a157d34ae29f7e8a6b8ce634cfc171ccbe368d3a09a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73706f6e736f72253230726f6f74732d3532356464633f6c6f676f3d676974687562266c6f676f436f6c6f723d666666666666266d6573736167653d)](https://github.com/sponsors/roots) [![KM Digital](https://camo.githubusercontent.com/a43c3d99df2424b5db9767c5c1af52bcebc5ce3685ede00f8472bcb1e4dd7792/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f6b6d2d6469676974616c2e737667)](https://k-m.com/) [![Carrot](https://camo.githubusercontent.com/a65d309f3418223caa092f5ed2aa85ff2fed82a001b56f4c9f396891c6c7152c/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f636172726f742e737667)](https://carrot.com/) [![C21 Redwood Realty](https://camo.githubusercontent.com/1ff89c28a54867bc095487baa5d392b019b643307c27831a68a1a0b1c006a40b/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f633231726564776f6f642e737667)](https://www.c21redwood.com/) [![WordPress.com](https://camo.githubusercontent.com/4daf2fea17fd7850dc12840a19cca8ece900f7eafcf8abb1e7c5dab08635fb6c/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f776f726470726573732e737667)](https://wordpress.com/) [![Pantheon](https://camo.githubusercontent.com/a627fb1c1f4f21a19bfa9ac8acff1617f6bf2c38d21dbb65a36d02923a951691/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f70616e7468656f6e2e737667)](https://pantheon.io/) Overview -------- [](#overview) 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](http://12factor.net/) methodology including the [WordPress specific version](https://roots.io/twelve-factor-wordpress/). Features -------- [](#features) - Better folder structure - Dependency management with [Composer](https://getcomposer.org) - Easy WordPress configuration with environment specific files - Environment variables with [Dotenv](https://github.com/vlucas/phpdotenv) - Autoloader for mu-plugins (use regular plugins as mu-plugins) - Enhanced security (separated web root and secure passwords with [wp-password-bcrypt](https://github.com/roots/wp-password-bcrypt)) Requirements ------------ [](#requirements) - PHP >= 7.4 - Composer - [Install](https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx) Installation ------------ [](#installation) 1. Create a new project: ``` $ composer create-project roots/bedrock ``` By default, this installs the `dist` version of all dependent packages. To install the `source` versions instead, update `composer.json` as follows: ``` "preferred-install": { "roots/wordpress-no-content": "dist", "*": "source" }, ``` 2. Update environment variables in the `.env` file. Wrap values that may contain non-alphanumeric characters with quotes, or they may be incorrectly parsed. - Database variables - `DB_NAME` - Database name - `DB_USER` - Database user - `DB_PASSWORD` - Database password - `DB_HOST` - Database host - Optionally, you can define `DATABASE_URL` for using a DSN instead of using the variables above (e.g. `mysql://user:password@127.0.0.1:3306/db_name`) - `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](https://github.com/aaemnnosttv/wp-cli-dotenv-command) - Generate with [our WordPress salts generator](https://roots.io/salts.html) 3. Add theme(s) in `web/app/themes/` as you would for a normal WordPress site 4. Set the document root on your webserver to Bedrock's `web` folder: `/path/to/site/web/` 5. Access WordPress admin at `https://example.com/wp/wp-admin/` Community --------- [](#community) Keep track of development and community news. - Join us on Discord by [sponsoring us on GitHub](https://github.com/sponsors/roots) - Participate on the [Roots Discourse](https://discourse.roots.io/) - Follow [@rootswp on Twitter](https://twitter.com/rootswp) - Read and subscribe to the [Roots Blog](https://roots.io/blog/) - Subscribe to the [Roots Newsletter](https://roots.io/subscribe/) ### Health Score 43 — FairBetter than 91% of packages Maintenance53 Moderate activity, may be stable Popularity10 Limited adoption so far Community19 Small or concentrated contributor base Maturity80 Battle-tested with a long release history Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~30 days Recently: every ~50 days Total 105 Last Release 1340d ago PHP version history (7 changes)1.0.0PHP >=5.3.0 1.1.0PHP >=5.3.2 1.3.0PHP >=5.4 1.4.5PHP >=5.5 1.7.0PHP >=5.6 1.11.0PHP >=7.1 1.18.0PHP >=7.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/4178291ccf36e3530aa8a8845124c3af1b24c064739ad98ded5b9679a4316033?d=identicon)[tombroucke](/maintainers/tombroucke) --- Top Contributors [![swalkinshaw](https://avatars.githubusercontent.com/u/295605?v=4)](https://github.com/swalkinshaw "swalkinshaw (205 commits)")[![retlehs](https://avatars.githubusercontent.com/u/115911?v=4)](https://github.com/retlehs "retlehs (176 commits)")[![austinpray](https://avatars.githubusercontent.com/u/2192970?v=4)](https://github.com/austinpray "austinpray (71 commits)")[![tombroucke](https://avatars.githubusercontent.com/u/24292260?v=4)](https://github.com/tombroucke "tombroucke (61 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (32 commits)")[![Log1x](https://avatars.githubusercontent.com/u/5745907?v=4)](https://github.com/Log1x "Log1x (26 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (17 commits)")[![dependencies-bot](https://avatars.githubusercontent.com/u/28956703?v=4)](https://github.com/dependencies-bot "dependencies-bot (12 commits)")[![QWp6t](https://avatars.githubusercontent.com/u/2104321?v=4)](https://github.com/QWp6t "QWp6t (10 commits)")[![tristanbes](https://avatars.githubusercontent.com/u/346010?v=4)](https://github.com/tristanbes "tristanbes (9 commits)")[![aaemnnosttv](https://avatars.githubusercontent.com/u/1621608?v=4)](https://github.com/aaemnnosttv "aaemnnosttv (8 commits)")[![tangrufus](https://avatars.githubusercontent.com/u/2259834?v=4)](https://github.com/tangrufus "tangrufus (6 commits)")[![knowler](https://avatars.githubusercontent.com/u/6908001?v=4)](https://github.com/knowler "knowler (5 commits)")[![alexsomeoddpilot](https://avatars.githubusercontent.com/u/5588412?v=4)](https://github.com/alexsomeoddpilot "alexsomeoddpilot (5 commits)")[![Foxaii](https://avatars.githubusercontent.com/u/1690407?v=4)](https://github.com/Foxaii "Foxaii (3 commits)")[![JulienMelissas](https://avatars.githubusercontent.com/u/2278221?v=4)](https://github.com/JulienMelissas "JulienMelissas (3 commits)")[![kellymears](https://avatars.githubusercontent.com/u/397606?v=4)](https://github.com/kellymears "kellymears (3 commits)")[![fredriksundstrom](https://avatars.githubusercontent.com/u/1112071?v=4)](https://github.com/fredriksundstrom "fredriksundstrom (2 commits)")[![huubl](https://avatars.githubusercontent.com/u/50170696?v=4)](https://github.com/huubl "huubl (2 commits)")[![louim](https://avatars.githubusercontent.com/u/923718?v=4)](https://github.com/louim "louim (2 commits)") --- Tags composerwordpresswprootsbedrockwp-config ### Code Quality Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/tombroucke-bedrock/health.svg) ``` [![Health](https://phpackages.com/badges/tombroucke-bedrock/health.svg)](https://phpackages.com/packages/tombroucke-bedrock) ``` ### Alternatives [roots/bedrock WordPress boilerplate with Composer, easier configuration, and an improved folder structure 6.5k441.8k2](/packages/roots-bedrock)[ronilaukkarinen/dudestack A modern WordPress stack 1131.2k](/packages/ronilaukkarinen-dudestack) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)