fourkitchens / emulsify
Project template for Drupal 8 themes
Installs: 187 875
Dependents: 0
Suggesters: 0
Security: 0
Stars: 164
Watchers: 36
Forks: 70
Open Issues: 67
Language:JavaScript
Type:drupal-theme
Requires
- drupal-pattern-lab/add-attributes-twig-extension: ^1.0
- drupal-pattern-lab/attach-library-twig-extension: ^1.0
- drupal-pattern-lab/bem-twig-extension: ^1.0
- drupal-pattern-lab/unified-twig-extensions: ^0.1
- drupal/components: ^1.0
- dev-develop
- v3.1
- v3.0
- v2.7
- v2.6
- v2.5
- v2.4
- 2.3
- v2.2
- v2.1
- v2.0.1
- v2.0.0
- v1.1.2
- v1.1.1
- v1.1.0
- v1.0.0
- dev-dependabot/npm_and_yarn/decode-uri-component-0.2.2
- dev-dependabot/npm_and_yarn/engine.io-and-browser-sync-6.2.1
- dev-dependabot/npm_and_yarn/xmldom-and-svg-sprite--removed
- dev-dependabot/npm_and_yarn/css-what-2.1.3
- dev-dependabot/composer/twig/twig-1.44.7
- dev-dependabot/composer/guzzlehttp/guzzle-6.5.8
- dev-dependabot/composer/guzzlehttp/psr7-1.8.5
- dev-dependabot/composer/symfony/http-kernel-3.4.49
- dev-dependabot/composer/drupal/core-8.9.20
- dev-dependabot/npm_and_yarn/follow-redirects-1.14.8
- dev-dependabot/npm_and_yarn/path-parse-1.0.7
- dev-dependabot/npm_and_yarn/tar-2.2.2
- dev-dependabot/npm_and_yarn/postcss-7.0.36
- dev-dependabot/npm_and_yarn/hosted-git-info-2.8.9
- dev-dependabot/npm_and_yarn/y18n-3.2.2
- dev-dependabot/npm_and_yarn/ini-1.3.7
- dev-dependabot/npm_and_yarn/node-sass-4.14.1
- dev-dependabot/npm_and_yarn/puppeteer-1.20.0
- dev-dependabot/npm_and_yarn/decompress-zip-0.3.2
- dev-dependabot/npm_and_yarn/https-proxy-agent-2.2.4
- dev-dependabot/composer/symfony/http-foundation-3.4.37
- dev-dependabot/composer/symfony/dependency-injection-3.4.35
- dev-dependabot/npm_and_yarn/mixin-deep-1.3.2
- dev-dependabot/npm_and_yarn/eslint-utils-1.4.3
- dev-dependabot/npm_and_yarn/lodash.merge-4.6.2
- dev-dependabot/npm_and_yarn/lodash.mergewith-4.6.2
- dev-115-eslint
- dev-master
- dev-291--nav-accessibility
- dev-theme-dependency
- dev-feature/window-support
- dev-wrapper-test
- dev-wrapper-mixin
- dev-yarn-lock
- dev-components/restart
- dev-restart/images
- dev-header-example
- dev-menu-dry-twig
- dev-revert-114-bugfix/bem-class-inheritance-4
- dev-feature/tables
- dev-wpt-tests
- dev-site
- dev-8.x-1.x
This package is auto-updated.
Last update: 2023-05-01 00:07:49 UTC
README
⚠️ You are viewing the legacy version of Emulsify ⚠️
You can find the current version of Emulsify Design System at github.com/emulsify-ds
If you'd like to upgrade your Emulsify project to the new version, check out this documentation.
Emulsify (legacy version)
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
- PHP 7.1
- Node (we recommend NVM)
- Gulp
- Composer
- Optional: Yarn
Prototyping (separate from Drupal, Wordpress, etc.)
Emulsify supports both NPM and YARN.
Install with NPM:
composer create-project fourkitchens/emulsify:^3.0 --stability dev --no-interaction emulsify && cd emulsify && npm install
Install with Yarn:
composer create-project fourkitchens/emulsify:^3.0 --stability dev --no-interaction emulsify && cd emulsify && yarn install
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"
(Runphp emulsify.php -h
for other available options) - Move into your theme directory
cd web/themes/custom/THEME_NAME/
- Install the theme dependencies
npm install
oryarn 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.
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.
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
oryarn start
Highlighted Features
Lightweight | ✔ | Emulsify is focused on being as lightweight as possible. |
SVG sprite support | ✔ | Automated support for creating SVG sprites. |
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) |
Automated Accessibility Testing | ✔ | Accessibility Testing using pa11y (https://github.com/fourkitchens/emulsify/wiki/Accessibility-Testing) |
Emulsify's Built in Components with Drupal support
Forms, tables, video, accordion, cards, breadcrumbs, tabs, pager, status messages, gridView 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
We have a series of videos for you to learn more about Emulsify.
For Designers (Prototyping)
See Designers
For Drupal 8 Developers
See Drupal Usage
Gulp Configuration
See Gulp Config