Emulsify
Component ID
Component name
Component type
Maintenance status
Development status
Component security advisory coverage
Downloads
Component created
Component changed
Component body
Pattern Lab + Drupal 8
Component-driven prototyping tool using Pattern Lab v2 automated via Gulp/NPM. Also serves as a starterkit Drupal 8 theme.
Requirements
Node (we recommend NVM)
Gulp
Composer
Optional: Yarn
Quickstart (Emulsify Standalone)
Emulsify supports both NPM and YARN.
Install with NPM: composer create-project fourkitchens/emulsify --stability dev --no-interaction emulsify && cd emulsify && npm install
Install with Yarn:composer create-project fourkitchens/emulsify --stability dev --no-interaction emulsify && cd emulsify && yarn install
Drupal-specific installation
composer require fourkitchens/emulsify
- Enable Emulsify and its dependencies
drush en emulsify components unified_twig_ext -y
- Optional: Create cloned theme
drush emulsify "THEME NAME"
(You may need to rundrush cc drush
to clear the drush cache. Also, you can rundrush help emulsify
for other available options) npm install
oryarn install
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.
Starting Pattern Lab and watch task
The start command spins up a local server, compiles everything (runs all required gulp tasks), and watches for changes.
npm start
or yarn start
Highlighted Features
Lightweight | ✔ | Emulsify is focused on being as lightweight as possible. |
SVG sprite support | ✔ | Automated support for creating SVG sprites mixins/classes. |
Stock Drupal templates | ✔ | Templates from Stable theme - see /templates directory |
Stock Components | ✔ | with Drupal support built-in (https://github.com/fourkitchens/emulsify#emulsifys-built-in-components-with-drupal-support) |
Performance Testing | ✔ | Support for testing via Google PageSpeed Insights and WebPageTest.org (https://github.com/fourkitchens/emulsify/wiki/Gulp-Config#performance-testing) |
Automated Github Deployment | ✔ | Deploy your Pattern Lab instance as a Github page (https://github.com/fourkitchens/emulsify/wiki/Gulp-Config#deployment) |
Emulsify's Built in Components with Drupal support
Forms, tables, video, accordion, cards, breadcrumbs, tabs, pager, status messages, grid
View a demo of these default Emulsify components.
Documentation
Documentation is currently provided in the Wiki. Here are a few basic links:
General Orientation
See Orientation
For Designers (Prototyping)
See Designers
For Drupal 8 Developers
See Drupal Usage
Gulp Configuration
See Gulp Config