Note: the Liferay theme generator is still in development and is not guaranteed to work on all platforms/environments.
Liferay theme generator allows you to generate new themes to be used with Liferay Portal, and supplies you with the necessary tools to deploy and make quick modifications to your theme.
- Install Node.JS, if you don't have it yet.
<sudo> npm install -g yoto install global dependencies.
- Install generator:
<sudo> npm install -g generator-liferay-theme
yo liferay-themeto start theme generator and follow prompts to name and configure your theme.
Note: the generator will create a new folder in your current directory that will house your theme.
Usage on Windows
Some additional steps may be required when using the generator on Windows. We use node-sass, which requires node-gyp to run, and node-gyp requires Python to be installed. You can read more at the following link:
liferay-theme:layout generator creates a layout template.
If you run the generator from the root directory of a theme (created with
yo liferay-theme) it will add the layout template as a part of the theme in
liferay-theme:themelet generator enables you to create theme fragments called
The advantage of themelets is that reused code/components that often exist in multiple themes can be abstracted and easily reused in all of your themes.
Once the generator is done creating your theme, there are multiple gulp tasks available to expedite theme development. See liferay-theme-tasks for more detail.
To test an unpublished change to the generator:
# Test the main theme generator: yo ./packages/generator-liferay-theme # Test the layout generator: yo ./packages/generator-liferay-theme/generators/layout/index.js # Test the themelet generator: yo ./packages/generator-liferay-theme/generators/themelet/index.js