PHPackages                             jazzman/wp-boilerplate - 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. [Utility & Helpers](/categories/utility)
4. /
5. jazzman/wp-boilerplate

ActiveProject[Utility & Helpers](/categories/utility)

jazzman/wp-boilerplate
======================

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

3.0(3y ago)053[6 PRs](https://github.com/Jazz-Man/wp-boilerplate/pulls)MITSCSSPHP ^7.4|^8.1

Since Nov 16Pushed 2y ago1 watchersCompare

[ Source](https://github.com/Jazz-Man/wp-boilerplate)[ Packagist](https://packagist.org/packages/jazzman/wp-boilerplate)[ Docs](https://roots.io/bedrock/)[ RSS](/packages/jazzman-wp-boilerplate/feed)WikiDiscussions master Synced yesterday

READMEChangelog (6)Dependencies (11)Versions (15)Used By (0)

[Bedrock](https://roots.io/bedrock/)
====================================

[](#bedrock)

[![Codacy Badge](https://camo.githubusercontent.com/40f97a389ea9b9f0fb3df07b59f24ce69bc4c028245da776dfecc3c039acedac/68747470733a2f2f6170692e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f6433393736333230663031393462313261316462363339646332646535633738)](https://app.codacy.com/gh/Jazz-Man/wp-boilerplate?utm_source=github.com&utm_medium=referral&utm_content=Jazz-Man/wp-boilerplate&utm_campaign=Badge_Grade_Settings)[![Packagist](https://camo.githubusercontent.com/43c0b95ecb968e1f4642fe19468e20caec6e20acc273b308b293b7efbd202ac6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726f6f74732f626564726f636b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/roots/bedrock)[![Build Status](https://camo.githubusercontent.com/efdd0ed1d2624beadabfc995a687e4587a4eccff1e680c875ac74f40ffd5eaa2/68747470733a2f2f696d672e736869656c64732e696f2f636972636c6563692f6275696c642f67682f726f6f74732f626564726f636b3f7374796c653d666c61742d737175617265)](https://circleci.com/gh/roots/bedrock)[![Follow Roots](https://camo.githubusercontent.com/2b8273856233cb73467f46b7b730c721f9b4d3b1751394e4127246f862720f34/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f666f6c6c6f772f726f6f747377702e7376673f7374796c653d666c61742d73717561726526636f6c6f723d316461316632)](https://twitter.com/rootswp)

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.1
- 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
    ```
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/`

Documentation
-------------

[](#documentation)

Bedrock documentation is available at .

Contributing
------------

[](#contributing)

Contributions are welcome from everyone. We have [contributing guidelines](https://github.com/roots/guidelines/blob/master/CONTRIBUTING.md) to help you get started.

Bedrock sponsors
----------------

[](#bedrock-sponsors)

Help support our open-source development efforts by [becoming a patron](https://www.patreon.com/rootsdev).

[![Kinsta](https://camo.githubusercontent.com/efddc19d1bac22ad7023a1590d7fd98658a3abc0a6d5e3ac01f7927b02b3d1f2/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f6b696e7374612e737667)](https://kinsta.com/?kaid=OFDHAJIXUDIV) [![KM Digital](https://camo.githubusercontent.com/a43c3d99df2424b5db9767c5c1af52bcebc5ce3685ede00f8472bcb1e4dd7792/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f6b6d2d6469676974616c2e737667)](https://k-m.com/) [![Scale Dynamix](https://camo.githubusercontent.com/592eddcd26dad40a611515c79349fad59bfe5b8a1501e0a1488f221b34c14c51/68747470733a2f2f63646e2e726f6f74732e696f2f6170702f75706c6f6164732f7363616c652d64796e616d69782e737667)](https://scaledynamix.com/)

Community
---------

[](#community)

Keep track of development and community news.

- 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/)
- Listen to the [Roots Radio podcast](https://roots.io/podcast/)

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor1

Top contributor holds 69.9% of commits — single point of failure

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 ~209 days

Recently: every ~232 days

Total

6

Last Release

1324d ago

Major Versions

1.3 → 2.02021-05-09

2.0 → 3.02022-09-27

PHP version history (3 changes)1.0PHP >=7.1

1.1PHP >=7.2

3.0PHP ^7.4|^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/bde0917196a65a6134bf7aa9d1b3969ae4ef3b92907662fdf68070d033de6843?d=identicon)[Jazz-Man](/maintainers/Jazz-Man)

---

Top Contributors

[![Jazz-Man](https://avatars.githubusercontent.com/u/6892898?v=4)](https://github.com/Jazz-Man "Jazz-Man (146 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (34 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (28 commits)")[![codacy-badger](https://avatars.githubusercontent.com/u/23704769?v=4)](https://github.com/codacy-badger "codacy-badger (1 commits)")

---

Tags

bedrockcomposermu-pluginswordpresswp-boilerplatecomposerwordpresswprootsbedrockwp-config

### Embed Badge

![Health badge](/badges/jazzman-wp-boilerplate/health.svg)

```
[![Health](https://phpackages.com/badges/jazzman-wp-boilerplate/health.svg)](https://phpackages.com/packages/jazzman-wp-boilerplate)
```

###  Alternatives

[roots/bedrock

WordPress boilerplate with Composer, easier configuration, and an improved folder structure

6.5k441.8k2](/packages/roots-bedrock)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)