Component-driven prototyping tool using Pattern Lab v2 automated via Gulp/NPM. Also serves as a starterkit Drupal 8 theme.

1. PHP 7.1
2. Node (we recommend NVM)
3. Gulp
4. Composer
5. Optional: Yarn

Emulsify supports both NPM and YARN.

Install with NPM: composer create-project fourkitchens/emulsify:^2.0 --stability dev --no-interaction emulsify && cd emulsify && npm install

Install with Yarn: composer create-project fourkitchens/emulsify:^2.0 --stability dev --no-interaction emulsify && cd emulsify && yarn install

1. Require emulsify in your project composer require fourkitchens/emulsify
2. Move into the original emulsify theme cd web/themes/contrib/emulsify/
3. Create your new theme by cloning emulsify php emulsify.php "THEME NAME" (Run php emulsify.php -h for other available options)
4. Move into your theme directory cd web/themes/custom/THEME_NAME/
5. Install the theme dependencies npm install or yarn install
6. Enable your theme and its dependencies drush then THEME_NAME -y && drush en components unified_twig_ext -y
7. Proceed to the "Starting Pattern Lab…" section below

If you're not using a Composer-based Drupal install (e.g. tarball download from drupal.org) installation instructions can be found on the Wiki.

Troubleshooting Installation: See Drupal Installation FAQ.

Note: Once you've created your custom theme, you can remove Emulsify as a dependency of your project. If you'd like to get updates as we push them, solely for educational/best-practice information, feel free to leave it in and receive the updates. Updating Emulsify will not affect your custom theme in any way.

The start command spins up a local server, compiles everything (runs all required gulp tasks), and watches for changes.

1. npm start or yarn start

View a demo of these default Emulsify components.

Documentation is currently provided in the Wiki. Here are a few basic links:

See Orientation

We have a series of videos for you to learn more about Emulsify.

See Designers

See Drupal Usage

See Gulp Config