PHPackages                             maartenvangelder/wordpress - 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 &amp; Helpers](/categories/utility)
4. /
5. maartenvangelder/wordpress

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

maartenvangelder/wordpress
==========================

A modern WordPress scaffold

v0.9.8.1(7mo ago)09BSD-3-ClausePHPPHP &gt;=8.1

Since Oct 4Pushed 7mo agoCompare

[ Source](https://github.com/maartenvangelder/wordpress)[ Packagist](https://packagist.org/packages/maartenvangelder/wordpress)[ Docs](https://maartenvangelder.nl/)[ RSS](/packages/maartenvangelder-wordpress/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (20)Versions (9)Used By (0)

Wordpress Scaffold
==================

[](#wordpress-scaffold)

A WordPress 'Pro' scaffold, based on the [Bedrock](https://github.com/roots/bedrock/) WordPress boilerplate, with a customized theme loosely based on [Sage](https://github.com/roots/sage/).

### Based on

[](#based-on)

- [roots/bedrock](https://github.com/roots/bedrock/) 1.7.x
- [roots/bedrock-capistrano](https://github.com/roots/bedrock-capistrano/)
- [roots/sage](https://github.com/roots/sage/) 8.5.x
- [grrr-amsterdam/gulpfile](https://github.com/grrr-amsterdam/gulpfile/)

Quick start
-----------

[](#quick-start)

### Create a new project

[](#create-a-new-project)

Run `composer create-project grrr-amsterdam/wordpress-scaffold `. This will create a new project in the chosen directory. It will also initiate an interactive shell where the following things will be done for you:

- Install root Composer dependencies
- Create and prefill a `.env` file (essentials only)
- Create a database
- Install WordPress
- Rename the theme folder
- Prefill the `style.css` file
- Install theme Composer dependencies
- Install npm packages
- Run `yarn build`
- Activate the theme and plugins

### Theme &amp; asset building

[](#theme--asset-building)

We use [Yarn](https://github.com/yarnpkg/yarn) for managing our front-end dependencies, and (grrr-gulpfile)\[\] for building all the assets. Commands should be run from inside the theme folder: `web/app/themes/*`.

- For watching and buildint, run `yarn watch` or `yarn build`
- For building production assets, run `yarn build:production`

### Deploying

[](#deploying)

We use [Capistrano](https://github.com/capistrano/capistrano) for deployments. Run `bundle install` to install the necessary requirements, or run `gem install bundler` first if you don't have [Bundler](https://github.com/bundler/bundler).

Initial server setup can be done via `cap  deploy:setup`, after verifiying that the server config is correct in `config/deploy/.rb` This will create a few directories, install Composer and WP-CLI, and copy some files which need to be persistent between deploys (eg. files in de `shared` folder).

Deployments and rollbacks can be done via:

`cap  deploy` and `cap  deploy:rollback`

Structure &amp; flow
--------------------

[](#structure--flow)

### Theme settings &amp; logic

[](#theme-settings--logic)

We try to avoid extensive logic in templates or partials. Most logic can be found in `lib\`, and all classes are autoloaded thru [PSR-4](http://www.php-fig.org/psr/psr-4/). Directories with classless functions (like `libs/Grrr/Utils` and `libs/Sage/`) need to be specified explicitly in the `functions.php`. Loading them thru Composer will fail, since we 'hoist' the theme composer dependencies to the main `composer.json` on install.

### Plugins &amp; dependencies

[](#plugins--dependencies)

WordPress and WordPress plugins should be required by Composer in the root of the project. Dependencies explicitly required by the theme (a SDK for accessing an API for example) should be included in the theme, which has its own `composer.json`.

Requiring a plugin works by using [WordPress Packagist](https://wpackagist.org/):

```
composer require wpackagist-plugin/

```

Paid plugins should be included in the repo, and excluded form exclusion in the `.gitignore` file.

### Updating WordPress &amp; plugins

[](#updating-wordpress--plugins)

Updating WordPress or plugins is as simple as running `composer update johnpbloch/wordpress` or `composer update` for everything. Paid plugins can be updated in development, whereafter the updated files can be committed to the repo.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance63

Regular maintenance activity

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

8

Last Release

225d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/46e09f1616b5bc438fcffe367aed1b6d0b73ed5ddab6aa5be3df63a4d08462dc?d=identicon)[maartenvangelder](/maintainers/maartenvangelder)

---

Top Contributors

[![maartenvangelder](https://avatars.githubusercontent.com/u/4192102?v=4)](https://github.com/maartenvangelder "maartenvangelder (8 commits)")

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/maartenvangelder-wordpress/health.svg)

```
[![Health](https://phpackages.com/badges/maartenvangelder-wordpress/health.svg)](https://phpackages.com/packages/maartenvangelder-wordpress)
```

###  Alternatives

[roots/bedrock

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

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

The WordPlate boilerplate

2.2k5.1k](/packages/vinkla-wordplate)

PHPackages © 2026

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