Acquia's toolset for automating Drupal 8 development, testing, and deployment.
Branch: 10.0.x
Clone or download
grasmash and mikemadison13 Test tests:acsf:validate (#3392)
* Test tests:acsf:validate

* Delete

Remove cloud hook readme.

* Update AcsfHooksTest.php

* Update AcsfHooksTest.php

* Update DeployTest.php
Latest commit d737f52 Feb 15, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Cherry-pick in lost/abandoned commits from 9.x (#3072) Sep 13, 2018
bin Fixes #2061: Validation doesn't occur in multisite paths. (#2369) Dec 14, 2017
build Fixes #974: Moving test:* targets to Robo PHP. (#1234) Apr 5, 2017
config Revert "[10.0.x] Drupal testing enhancements." (#3348) Jan 25, 2019
docs Updates release and readme docs. (#3382) Feb 13, 2019
drush Massive refactor of BLT doctor. (#2400) Jan 7, 2018
scripts Test tests:acsf:validate (#3392) Feb 15, 2019
settings Fix code style standards in settings files. (#3375) Feb 11, 2019
src Updating and setting version for 10.0.0-beta2. Feb 14, 2019
subtree-splits Fixes #3355 to update devel in 10.x. (#3356) Feb 4, 2019
template Revert "[10.0.x] Drupal testing enhancements." (#3348) Jan 25, 2019
tests/phpunit Test tests:acsf:validate (#3392) Feb 15, 2019
.editorconfig Use tab indents for *.mk makefiles (#3018) Aug 29, 2018
.gitattributes Initial commit. Apr 27, 2016
.github_changelog_generator Scripting releases. (#948) Jan 10, 2017
.gitignore Fixes issue #2744: Remove wikimedia/composer-merge-plugin from BLT. (#… Oct 6, 2018
.ruby-version Adding .ruby-version for local development. Dec 6, 2016
.travis.yml 10.0.x: Upgrade BLT to Xenial on Travis CI (#3340) Jan 22, 2019 Updating and setting version for 10.0.0-beta2. Feb 14, 2019
LICENSE.txt Update License to GPL v2 [ci skip] May 25, 2016 Updates release and readme docs. (#3382) Feb 13, 2019
RoboFile.php Fixes issue #2744: Remove wikimedia/composer-merge-plugin from BLT. (#… Oct 6, 2018
acquia-pipelines.yml Move internal testing to Robo. (#2144) Oct 19, 2017
blt-logo.png Adding logo image. Oct 11, 2017
composer.json Pin memcache to 2.0-alpha7 until Acquia cloud is ready. (#3361) Feb 4, 2019
id_rsa_blt.enc Workin on BLT deploys. (#152) (#153) Jun 14, 2016
id_rsa_blted8.enc Updating id_rsa_blted8.enc to 4906 byte key. Mar 10, 2017
mkdocs.yml Docksal documentation (#3330) Jan 10, 2019
phpcs.xml.dist Refactoring blt.settings.php. (#2038) Sep 26, 2017
phpunit.xml.dist Fixes issue #2744: Remove wikimedia/composer-merge-plugin from BLT. (#… Oct 6, 2018
travis.php.ini Increasing PHP memory limit. Feb 8, 2018


BLT logo of stylized sandwich

Build Status Documentation Status Packagist Stories in Ready

BLT (Build and Launch Tool) provides an automation layer for testing, building, and launching Drupal 8 applications.

You can find all BLT documentation on Read the Docs:

Getting started

See for a list of prequisites and links to instructions for creating new projects, adding BLT to existing projects, and updating BLT.


Releases and versioning

Up to the last two most major versions of BLT are actively supported. The newest major version will receive both bug fixes and new features, while the penultimate major version will recieve bug fixes for at least two months. For example, if 8.8.1 is the most recent version of BLT:

  • As of the first cut tag for 8.8.x, 8.7.x will enter "LTS".
    • 8.7.x will continue to receive bug fixes and minor features
    • 8.7.x will not receive any major new features or backwards incompatible changes
  • Two months after the first cut tag for 8.8.x
    • 8.7.x will no longer be supported
    • 8.9.x will be created for major new features.
  • At some point later, 8.9.0 will be cut, and 8.8.x will enter "LTS".

Release support status

Major Version Support Status Drupal Drush Dev Status
10.0.x Unsupported (Beta) >=8.6 >=9.4.0 *active dev
9.2.x Supported 8.6 >=9.4.0 *active dev
9.x LTS, EOL TBA 8.5 >=9.1.0 *bug fixes
8.9.x Unsupported, EOL <=8.5 ~8
8.8.x Unsupported, EOL <=8.3 ~8
8.7.x Unsupported, EOL <=8.3 ~8

10.0.x branch

The 10.0.x branch is currently in beta and is not currently stable or supported. It requires Drush 9.4.x, Drupal 8.6.x, and PHP 7+. It is considered a major release because it removes the Composer merge plugin that BLT previously used to manage dependencies.

9.2.x branch

The 9.2.x branch is currently in development and supported. It requires Drush 9.4.x and Drupal 8.6.x.

9.x branch

The 9.x branch is currently in LTS and receiving bug fixes only. It requires Drush 9 and Drupal 8.5.x. It will be supported until Drupal 8.5.x is EOL.

Philosophy and Purpose

BLT is designed to improve efficiency and collaboration across Drupal projects by providing a common set of tools and standardized structure. It was born out of the need to reduce re-work, project set up time, and developer onboarding time.

Its explicit goals are to:

  • Provide a standard project template for Drupal based projects
  • Provide tools that automate the setup, testing, launching, and maintenance work for projects
  • Document and enforce Drupal standards and best practices via default configuration, automated testing, and continuous integration

Its scope is discretely defined. It is not intended to provide:

  • Drupal application features (e.g., workflow, media, layout, pre-fabbed content types, etc.)
  • A local hosting environment
  • A replacement for good judgement (as with Drupal, it leaves you the freedom to make mistakes)


Support and contribution

BLT is provided as an open source tool in the hope that it will enable developers to easily generate new Drupal projects that conform to Acquia Professional Services' best practices.

Please feel free to contribute to the project or file issues via the GitHub issue queue. See for contribution guidelines and instructions.

We also provide a limited FAQ for common issues.


Copyright (C) 2016 Acquia, Inc.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.