Distribution developers guide

Relevant specifications

As you develop your distribution, you can take steps to ensure that what you build is compatible with the features provided by other distribution developers.

  • The Kit feature specification provides specific guidelines for ensuring your distribution's features integrate with diverse sites and the features provided by other distributions.
  • The Open App specification provides specific guidelines for ensuring your distribution's features integrate with diverse sites and the features provided by other distributions.

Efforts are underway to expand the Kit specification, see #1456518: Governance of the Kit Spec. One extension of the Kit specification is Debut, which provides extended guidelines for feature integration.

See also #1554852: Define Drupal Distribution Experience (#DDX) commitment.

Key tools

  • The Features module is the leading tool for capturing bundles of configuration in Drupal distributions.

Additional tools

  • Apps "provides facilities to download modules and all of their dependencies in one easy step".

More details about distributions

Setting up a Drupal site typically involves downloading and configuring Drupal core, then downloading and configuring various contributed modules, as needed. To make this process easier, there are a variety of "pre-configured" versions of Drupal you can download and use for specific types of sites (e.g. a blogging site, a conference site, a corporate Intranet site, etc.). These "pre-configured" versions of Drupal are called "distributions".

Finding distributions

Drupal distributions are listed as projects in Download & Extend, filterable by compatibility, popularity, keyword, and more. Many distributions include code (such as the jQuery library) that cannot be hosted on drupal.org due to incompatible licensing, so downloads of these distributions are provided via a 3rd party website.

Distributions vs installation profiles

There is sometimes confusion regarding the terms "distribution" and "installation profile" (also called "install profile"). Here are the definitions:

    Subscribe with RSS Subscribe to RSS - Installation Profiles