PHPackages                             floe/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. [DevOps &amp; Deployment](/categories/devops)
4. /
5. floe/drupal-project

ActiveProject[DevOps &amp; Deployment](/categories/devops)

floe/drupal-project
===================

Composer template for Drupal 8 projects hosted on Pantheon and using Docker for local development environment

8.x-dev(9y ago)236GPL-2.0+PHP

Since Jan 25Pushed 9y ago1 watchersCompare

[ Source](https://github.com/FloeDesignTechnologies/drupal-project)[ Packagist](https://packagist.org/packages/floe/drupal-project)[ RSS](/packages/floe-drupal-project/feed)WikiDiscussions 8.x Synced 4w ago

READMEChangelogDependencies (13)Versions (1)Used By (0)

Composer template for Drupal 8 projects hosted on Pantheon and using Docker for local development environment
=============================================================================================================

[](#composer-template-for-drupal-8-projects-hosted-on-pantheon-and-using-docker-for-local-development-environment)

**⚠️ Experimental project**

This project template should provide a kickstart for

- managing your local development environment with Docker
- managing your site dependencies with [Composer](https://getcomposer.org/)
- hosting your site on Pantheon

Usage
-----

[](#usage)

First you need to install [docker](http://www.docker.com/products/docker), and [docker-compose](https://docs.docker.com/compose/install/). If using OS X, [install GNU coreutils](http://macappstore.org/coreutils/) or any other implementation of the `realpath` command.

After that you can create the project:

```
docker run --rm -v $(pwd):/var/www/html -v $HOME/.composer/cache:/root/.composer/cache -e COMPOSER_ALLOW_SUPERUSER=1 -e USER_UID=$(id -u) -e USER_GUID=$(id -g) drupaldocker/php:7-cli composer create-project --stability dev --ansi floe/drupal-project some-dir 8.x

```

Use `docker-compose` to run applications inside the configured Docker containers:

- `docker-compose run php-cli bash`: Enter a shell to execute cli applications (Composer, Drush, Drupal Console, etc.)
- `docker-compose up web`: Start a web server inside its own Docker container, accessible as .

*Aliases* for the most used commands to run inside the Docker containers are provided in the `bin` directory. It is suggested to put `bin` in your `PATH` while working on the project. The recommended way is to use [direnv](http://direnv.net/)

See the `docker-compose` file for details of the configured containers.

The `create-project` command above passes ownership of all files to the project that is created. You should create a new git repository, update the README.me and composer.json file, then commit all files not excluded by the .gitignore file.

What does the template do?
--------------------------

[](#what-does-the-template-do)

- Docker containers to work on the project are defined in the `docker-compose.yml` file.
- *Aliases* for the most used commands to run inside the Docker containers are provided in the `bin` directory.
- Drupal will be installed in the `web`-directory.
- Autoloader is implemented to use the generated composer autoloader in `vendor/autoload.php`, instead of the one provided by Drupal (`web/vendor/autoload.php`).
- Modules (packages of type `drupal-module`) will be placed in `web/modules/contrib/`
- Theme (packages of type `drupal-theme`) will be placed in `web/themes/contrib/`
- Profiles (packages of type `drupal-profile`) will be placed in `web/profiles/contrib/`
- Creates default writable versions of `settings.php` and `services.yml`.
- Creates `sites/default/files`-directory.
- Latest version of drush is installed locally for use at `vendor/bin/drush`.
- Latest version of DrupalConsole is installed locally for use at `vendor/bin/drupal`.

Updating Drupal Core
--------------------

[](#updating-drupal-core)

This project will attempt to keep all of your Drupal Core files up-to-date; the project [drupal-composer/drupal-scaffold](https://github.com/drupal-composer/drupal-scaffold)is used to ensure that your scaffold files are updated every time drupal/core is updated. If you customize any of the "scaffolding" files (commonly .htaccess), you may need to merge conflicts if any of your modfied files are updated in a new release of Drupal core.

Follow the steps below to update your core files.

1. Run `composer update drupal/core --with-dependencies` to update Drupal Core and its dependencies.
2. Run `git diff` to determine if any of the scaffolding files have changed. Review the files for any changes and restore any customizations to `.htaccess` or `robots.txt`.
3. Commit everything all together in a single commit, so `web` will remain in sync with the `core` when checking out branches or running `git bisect`.
4. In the event that there are non-trivial conflicts in step 2, you may wish to perform these steps on a branch, and use `git merge` to combine the updated core files with your customized files. This facilitates the use of a [three-way merge tool such as kdiff3](http://www.gitshah.com/2010/12/how-to-setup-kdiff-as-diff-tool-for-git.html). This setup is not necessary if your changes are simple; keeping all of your modifications at the beginning or end of the file is a good strategy to keep merges easy.

FAQ
---

[](#faq)

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

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

If you need to apply patches (depending on the project being modified, a pull request is often a better solution), 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"
        }
    }
}
```

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 68.3% 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

Unknown

Total

1

Last Release

3443d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2f6b76cb5ff0fa15479970b993cc4684a38587aacfc2f05889dc09bbf371507b?d=identicon)[pbuyle](/maintainers/pbuyle)

---

Top Contributors

[![webflo](https://avatars.githubusercontent.com/u/123946?v=4)](https://github.com/webflo "webflo (82 commits)")[![greg-1-anderson](https://avatars.githubusercontent.com/u/612191?v=4)](https://github.com/greg-1-anderson "greg-1-anderson (4 commits)")[![weitzman](https://avatars.githubusercontent.com/u/7740?v=4)](https://github.com/weitzman "weitzman (4 commits)")[![derhasi](https://avatars.githubusercontent.com/u/118502?v=4)](https://github.com/derhasi "derhasi (3 commits)")[![jmolivas](https://avatars.githubusercontent.com/u/366275?v=4)](https://github.com/jmolivas "jmolivas (3 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)")[![pbuyle](https://avatars.githubusercontent.com/u/27399?v=4)](https://github.com/pbuyle "pbuyle (2 commits)")[![bradjones1](https://avatars.githubusercontent.com/u/981966?v=4)](https://github.com/bradjones1 "bradjones1 (2 commits)")[![michaellenahan](https://avatars.githubusercontent.com/u/219397?v=4)](https://github.com/michaellenahan "michaellenahan (1 commits)")[![mickaelperrin](https://avatars.githubusercontent.com/u/5844226?v=4)](https://github.com/mickaelperrin "mickaelperrin (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)")[![pfrenssen](https://avatars.githubusercontent.com/u/442924?v=4)](https://github.com/pfrenssen "pfrenssen (1 commits)")[![tstoeckler](https://avatars.githubusercontent.com/u/3929504?v=4)](https://github.com/tstoeckler "tstoeckler (1 commits)")[![bartfeenstra](https://avatars.githubusercontent.com/u/376735?v=4)](https://github.com/bartfeenstra "bartfeenstra (1 commits)")[![zaporylie](https://avatars.githubusercontent.com/u/1690685?v=4)](https://github.com/zaporylie "zaporylie (1 commits)")[![bojanz](https://avatars.githubusercontent.com/u/330162?v=4)](https://github.com/bojanz "bojanz (1 commits)")[![bramcordie](https://avatars.githubusercontent.com/u/1107185?v=4)](https://github.com/bramcordie "bramcordie (1 commits)")[![deviantintegral](https://avatars.githubusercontent.com/u/255023?v=4)](https://github.com/deviantintegral "deviantintegral (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/floe-drupal-project/health.svg)

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

###  Alternatives

[farmos/farmos

A web-based farm record keeping application.

1.3k7.0k1](/packages/farmos-farmos)[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.3k10](/packages/helsingborg-stad-municipio)[fourkitchens/sous-drupal-project

Starter project for Sous a Drupal distribution featuring a theme based on Emulsify Design System.

141.1k](/packages/fourkitchens-sous-drupal-project)

PHPackages © 2026

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