PHPackages                             cheeky-monkey-media/drupal-project - 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. cheeky-monkey-media/drupal-project

ActiveProject[Framework](/categories/framework)

cheeky-monkey-media/drupal-project
==================================

Project template for Drupal 8 projects with composer, with cheeky helpers.

8.5.0(7y ago)258GPL-2.0-or-laterPHP

Since Feb 21Pushed 7y ago3 watchersCompare

[ Source](https://github.com/Cheeky-Monkey-Media/drupal-project)[ Packagist](https://packagist.org/packages/cheeky-monkey-media/drupal-project)[ RSS](/packages/cheeky-monkey-media-drupal-project/feed)WikiDiscussions 8.x Synced 3w ago

READMEChangelog (2)Dependencies (31)Versions (15)Used By (0)

Requirements
------------

[](#requirements)

- Docker:
- Lando:
- Monkey Wrench:

Local Development
-----------------

[](#local-development)

### Get latest code and start a feature branch.

[](#get-latest-code-and-start-a-feature-branch)

- Clone the working repo (bitbucket).
- `cd [project root]`
- `git checkout master` - Start all new features from master.
- `git pull origin master` - To make sure you have the latest code.
- `git checkout -b feature/[ID-123]--[short-description]` - Create new feature branch thusly.

### Install site in local docker environment with Lando tooling.

[](#install-site-in-local-docker-environment-with-lando-tooling)

*First time setup, please remember the following:*

- Make sure `web/sites/default/services.local.yml` is in place. (see `mw copy`)
- Make sure `web/sites/default/settings.local.php` is in place. (see `mw copy`)
- Make sure `web/sites/default/settings.php` includes settings.local.php.
    - Double check your db settings etc in the above files.
    - Use `lando info` for db connection info.
- Import your database. `lando db-import`

*Spin up the local:*

- `lando start` - Spin up the environment.
- `lando build -y` - Clean composer install.
- `lando build:theme` - Build the theme assets.
- `lando build:reset` - Runs local-dev.sh to updb, cim, cr ...

**Ready to work.**

Module Management
-----------------

[](#module-management)

From the project root:

### Adding Contrib Modules

[](#adding-contrib-modules)

- `lando composer require drupal/[package_name] --no-update` to add it to the composer.json without updating everything.
- `lando composer update drupal/[package_name]` to fetch/update only the desired module.

### Updating Contrib Modules

[](#updating-contrib-modules)

- `lando composer update drupal/[package_name]`

Sometimes several contrib modules are several versions behind.

*Do not use `lando composer update` without specifying a module, or it will update everything that's outdated at once, possibly introducing regressions which you'll have to do much more testing for.*

*Updates should be controlled and tested well. It's easiest to do that in smaller chunks. Especially watch out for BETA, ALPHA, or DEV versions of modules which are not stable and make no guarantees about not breaking things between updates.*

### Removing Contrib Modules

[](#removing-contrib-modules)

- `lando composer remove` will remove a package from require or require-dev.
- A clean build `lando build` of the codebase will delete contribs and vendor code and rebuild, without the removed modules.

### How can I apply patches to downloaded modules?

[](#how-can-i-apply-patches-to-downloaded-modules)

If you need to apply patches, you can do so with the [composer-patches](https://github.com/cweagans/composer-patches) plugin.

To add a patch to drupal module foobar insert the patches section in the extra section of composer.json:

```
"extra": {
    "patches": {
        "drupal/foobar": {
            "Patch description": "URL to patch"
        }
    }
}
```

To Deploy
---------

[](#to-deploy)

**If you're going to deploy, especially to production, make sure you understand how to configure, and what's happening during, the deploy process. It's great that we can automate things, but if you don't know what the machine is doing, you're going to panic or have a really hard time if something goes wrong.**

**Automation is a tool to make developers more efficient, not a replacement for knowledge and competency. Make sure a responsible adult is around to help.**

**MAKE A BACKUP of CODE, FILES AND DATABASE before deploying TO PRODUCTION**

**You should have the working repo configured first. See above.**

- If you haven't already: Clone the PRODUCTION repo aka: the "build artifact" (from host i.e. pantheon) to `[project root]/data/_deploy`
    - From `[project root]` do:
        - `git clone [production git url] data/_deploy`

*Back in the working repo:*

- `git checkout [branch to deploy]` develop or staging/staging-\[version\].
- `lando build -y` - Clean composer install.
- `lando build:theme` IMPORTANT: Compiled theme assets like CSS and JS are not committed to the working repo they must be generated.
    - These compiled assets will be synced with the production repo during deploy.
- **Make sure you have Monkey Wrench v2.2**
    - `mw version` should show you `v2.2`
    - `mw version-set v2.2` - to switch to the correct version.
    - If either of those commands fail, you have an outdated MW.
        - Try `mw update-mw` to pull the latest code.
        - Then use the commands above to make sure you're on `v2.2`.
        - If `mw update-mw` doesn't do anything... you have a REALLY outdated MW, or no MW at all. Please see: [Monkey Wrench](https://bitbucket.org/cheekymonkeymedia/monkey-wrench/src/master/)
- `mw deploy [develop|stage|master] `
    - This will sync the required elements from the local build to the production repo, commit and push to the host.

**Watch for errors in the sync and git push.**

### Troubleshooting Deploy:

[](#troubleshooting-deploy)

#### Deployment Configuration Checklist

[](#deployment-configuration-checklist)

- Using proper mw version? `v2.2` projects will have a `scripts/deploy` file to configure details about the deploy for that project. `v1.5` projects will have a `deploy.ini` file.
- `v2.2` is your `scripts/deploy` file configured properly? If others can deploy the project without issue, then it likely is. If not, RTFM or ask a wise monkey for assitance.
- `v2.2` Have you cloned the build artifact (repo) to the default `data/_deploy` (or whatever path is configured in `scripts/deploy`)?

#### Other common issues *not related to `mw deploy`*

[](#other-common-issues-not-related-to-mw-deploy)

`lando build` or `lando build:theme` errors:

- `lando rebuild` to rebuild local containers.
- Restart Docker: because `lando rebuild` didn't help and you just need to flush the system.
- `lando destroy && lando start` because Docker Restart didn't help and you **really** mean it this time.
- NUKE VIRTUALIZATION TOOLS - Reinstall Lando, or Docker, or Both. *Obviously a last resort.* You shouldn't have to do this, unless maybe you updated one or the other recently and something isn't right.
- Flip Table (╯°□°）╯︵ ┻━┻ - Re-evaluate your life.

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 61.6% 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 ~40 days

Recently: every ~86 days

Total

13

Last Release

2694d ago

Major Versions

7.x-dev → 8.1.02018-01-15

### Community

Maintainers

![](https://www.gravatar.com/avatar/0a878ec244783c4786aafadcd0b9bbc12ce280b5b0ef8a0c4b7e4e698eed89c3?d=identicon)[sleepingmonk](/maintainers/sleepingmonk)

---

Top Contributors

[![webflo](https://avatars.githubusercontent.com/u/123946?v=4)](https://github.com/webflo "webflo (117 commits)")[![sleepingmonk](https://avatars.githubusercontent.com/u/6646958?v=4)](https://github.com/sleepingmonk "sleepingmonk (25 commits)")[![pfrenssen](https://avatars.githubusercontent.com/u/442924?v=4)](https://github.com/pfrenssen "pfrenssen (6 commits)")[![derhasi](https://avatars.githubusercontent.com/u/118502?v=4)](https://github.com/derhasi "derhasi (4 commits)")[![weitzman](https://avatars.githubusercontent.com/u/7740?v=4)](https://github.com/weitzman "weitzman (4 commits)")[![greg-1-anderson](https://avatars.githubusercontent.com/u/612191?v=4)](https://github.com/greg-1-anderson "greg-1-anderson (4 commits)")[![jmolivas](https://avatars.githubusercontent.com/u/366275?v=4)](https://github.com/jmolivas "jmolivas (3 commits)")[![bradjones1](https://avatars.githubusercontent.com/u/981966?v=4)](https://github.com/bradjones1 "bradjones1 (2 commits)")[![jorissteyn](https://avatars.githubusercontent.com/u/448056?v=4)](https://github.com/jorissteyn "jorissteyn (2 commits)")[![jonhattan](https://avatars.githubusercontent.com/u/482058?v=4)](https://github.com/jonhattan "jonhattan (2 commits)")[![jcnventura](https://avatars.githubusercontent.com/u/329663?v=4)](https://github.com/jcnventura "jcnventura (2 commits)")[![mikran](https://avatars.githubusercontent.com/u/820244?v=4)](https://github.com/mikran "mikran (1 commits)")[![ModulesUnraveled](https://avatars.githubusercontent.com/u/1663810?v=4)](https://github.com/ModulesUnraveled "ModulesUnraveled (1 commits)")[![opdavies](https://avatars.githubusercontent.com/u/339813?v=4)](https://github.com/opdavies "opdavies (1 commits)")[![rwanyoike](https://avatars.githubusercontent.com/u/3677497?v=4)](https://github.com/rwanyoike "rwanyoike (1 commits)")[![Saphyel](https://avatars.githubusercontent.com/u/5764721?v=4)](https://github.com/Saphyel "Saphyel (1 commits)")[![thom8](https://avatars.githubusercontent.com/u/331453?v=4)](https://github.com/thom8 "thom8 (1 commits)")[![tstoeckler](https://avatars.githubusercontent.com/u/3929504?v=4)](https://github.com/tstoeckler "tstoeckler (1 commits)")[![bojanz](https://avatars.githubusercontent.com/u/330162?v=4)](https://github.com/bojanz "bojanz (1 commits)")[![zaporylie](https://avatars.githubusercontent.com/u/1690685?v=4)](https://github.com/zaporylie "zaporylie (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/cheeky-monkey-media-drupal-project/health.svg)

```
[![Health](https://phpackages.com/badges/cheeky-monkey-media-drupal-project/health.svg)](https://phpackages.com/packages/cheeky-monkey-media-drupal-project)
```

###  Alternatives

[az-digital/az_quickstart

Arizona Quickstart

52265.6k3](/packages/az-digital-az-quickstart)[govcms/govcms

GovCMS Drupal Distribution

196100.6k3](/packages/govcms-govcms)[thunder/thunder-distribution

The thunder distribution

51653.5k3](/packages/thunder-thunder-distribution)[goalgorilla/open_social

Open Social is a distribution for building social communities and intranets.

190461.9k](/packages/goalgorilla-open-social)[drupalwxt/wxt

Project template for Drupal 10 sites built with the WxT distribution.

29163.3k8](/packages/drupalwxt-wxt)

PHPackages © 2026

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