fourkitchens/emulsify

Project template for Drupal 8 themes

Sunday, July 8, 2018
by ModulesUnraveled
Repository
24 Watchers
109 Stars
15,526 Installations

JavaScript
0 Dependents
0 Suggesters
51 Forks
30 Open issues
43 Versions
43 % Grown

The README.md

, _(*1)

Emulsify: Pattern Lab + Drupal 8

Component-driven prototyping tool using Pattern Lab v2 automated via Gulp/NPM. Also serves as a starterkit Drupal 8 theme., _(*2)

Requirements

Prototyping (separate from Drupal, Wordpress, etc.)

Emulsify supports both NPM and YARN., _(*3)

Install with NPM: composer create-project fourkitchens/emulsify:^3.0 --stability dev --no-interaction emulsify && cd emulsify && npm install, _(*4)

Install with Yarn: composer create-project fourkitchens/emulsify:^3.0 --stability dev --no-interaction emulsify && cd emulsify && yarn install, _(*5)

Drupal installation

In a Composer-based Drupal install (recommended)

Require emulsify in your project composer require fourkitchens/emulsify
Move into the original emulsify theme cd web/themes/contrib/emulsify/
Create your new theme by cloning emulsify php emulsify.php "THEME NAME" (Run php emulsify.php -h for other available options)
Move into your theme directory cd web/themes/custom/THEME_NAME/
Install the theme dependencies npm install or yarn install
Enable your theme and its dependencies drush then THEME_NAME -y && drush en components unified_twig_ext -y
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., _(*6)

Troubleshooting Installation: See Drupal Installation FAQ., _(*7)

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., _(*8)

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., _(*9)

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, _(*10)

View a demo of these default Emulsify components., _(*11)

Documentation

Documentation is currently provided in the Wiki. Here are a few basic links:, _(*12)

General Orientation

See Orientation, _(*13)

We have a series of videos for you to learn more about Emulsify., _(*14)

For Designers (Prototyping)

See Designers, _(*15)

For Drupal 8 Developers

See Drupal Usage, _(*16)

Gulp Configuration

See Gulp Config, _(*17)

The Versions

08/07 2018

dev-feature/circleci

dev-feature/circleci http://emulsify.info

Project template for Drupal 8 themes

drupal-theme emulsify

Project template for Drupal 8 themes

fourkitchens/emulsify

The README.md

Emulsify: Pattern Lab + Drupal 8

Requirements

Prototyping (separate from Drupal, Wordpress, etc.)

Drupal installation

In a Composer-based Drupal install (recommended)

Starting Pattern Lab and watch task

Highlighted Features

Emulsify's Built in Components with Drupal support

Documentation

General Orientation

For Designers (Prototyping)

For Drupal 8 Developers

Gulp Configuration

The Versions

dev-feature/circleci

The Requires

by Brian Lewis

by Evan Willhite

by Chris Martin

by Randy Oest

dev-develop

The Requires

by Brian Lewis

by Evan Willhite

by Chris Martin

by Randy Oest

dev-wrapper-test

The Requires

by Brian Lewis

by Evan Willhite

by Chris Martin

by Randy Oest

dev-wrapper-mixin

The Requires

by Brian Lewis

by Evan Willhite

by Chris Martin

by Randy Oest

dev-master

The Requires

by Brian Lewis

by Evan Willhite

by Chris Martin

by Randy Oest

v2.6

The Requires

by Brian Lewis

by Evan Willhite

by Chris Martin

by Randy Oest

dev-65-attach-library

The Requires

by Brian Lewis

by Evan Willhite

by Chris Martin

by Randy Oest

dev-yarn-lock

The Requires

by Brian Lewis

by Evan Willhite

by Chris Martin

by Randy Oest

v2.5

The Requires

by Brian Lewis

by Evan Willhite

by Chris Martin

by Randy Oest

v2.4

The Requires

by Brian Lewis

by Evan Willhite

by Chris Martin

by Randy Oest

dev-177-view-example

The Requires