An atomic design and Pattern Lab friendly starting point for new component-based Drupal 8 themes πŸ•
Switch branches/tags
Clone or download

README.md

Shila theme for Drupal 8

An atomic design and Pattern Lab friendly starting point for new Drupal 8 themes. Can be used stand-alone with Pattern Lab. Can be used as a Pattern Lab StarterKit as well.

Shila theme is based on pattern-lab-project and uses shila-css.

Please note that theme-specific CSS files are not committed to the repository. They can be generated after installing development dependencies.

Installing development dependencies

Prerequisites: npm installed.

In the Shila theme root directory run:

npm install

Generating theme-specific CSS files

In the Shila theme root directory run:

gulp sass

Integrating with Drupal

Required: Component Libraries module

Install and enable the Component Libraries module. No configuration is needed.

Optional: UI Patterns module

Install and enable the UI Patterns module. Some components have a ui_patterns.yml definition file, which enables them to be used with UI Patterns.

Integrating with Pattern Lab

Prerequisites: npm and Composer installed.

In the Shila theme root directory run:

npm run install-pattern-lab

This will download Pattern Lab, make required configuration changes and generate the Pattern Lab website. The command will not do anything if a pattern-lab directory already exists.