@bloomreach/hippo-theme

Hippo Theme

The Hippo theme is a centralised library containing reusable components for Hippo-related projects. You can use it to create clickable mockups or end-projects that need to be in line with the Hippo styling.

Development environment setup

Prerequisites

• NodeJS
• Git

Installation

Run the commands below in the project root directory.

$ npm ci

Useful commands

Generate build

The build version is located in the dist directory.

$ npm run build

Run tests

The tests need to pass in order to build the demo.

$ npm test

Setup server

The browser will show the demo website which shows all available components for the theme.

$ npm start

Watch task for the Hippo theme during development

When working on end projects that use Hippo theme, sometimes changes need to be made to Hippo theme and you want to see the results right away. For this we can use npm link. First create a global link to the Hippo theme

$ npm link

On OSX, you may need super-user privileges to create this link. Assuming you have a watch task with livereload enabled running in your end project, you can use the npmlink_watch task to watch the Hippo theme files (running two live-reload watch tasks in parallel is not possible)

$ npm run npmlink_watch

Then in your end project run

$ npm link hippo-theme

When the link is no longer necessary, simply remove it on the project side with

$ npm uninstall hippo-theme

and in your global NPM library with

$ npm unlink

This, too, may require super-user privileges on OSX.

Deployment to NPM

$ npm publish

Development

Adding icons

To add an icon to the theme and use it in the CMS Java code, perform the following steps:

• Add the .svg file to the src/images/icons folder
• Ensure that there is a copyright header
• Ensure that the icons does have color by setting 'fill="currentColor"' or 'stroke="currentColor"' where applicable
• Add the icon to the demo page
• Add the icon constant to the CMS project's Icon.java (api/src/main/java/org/hippoecm/frontend/skin/Icon.java)