lr-cx-helper
v2.2.4
Published
## Overview
Downloads
225
Readme
Liferay Client Extension Helper
Overview
lr-cx-helper
is a command-line tool designed to simplify the generation of Liferay Node.js backend Client extension project structures. This tool automates the creation of two projects: one to host your source code and another to host the Liferay client extension. The primary goal of lr-cx-helper
is to streamline the process of compiling and building Node.js projects into a single executable file while minimizing the source code and encapsulating all required dependencies within it. This eliminates the need for manual installation of dependencies using npm i
, making deployment and distribution more straightforward.
Features
- Project Generation: Automatically generates project structures for Liferay Node.js backend Client extensions.
- Dependency Management: Minimizes the source code and encapsulates dependencies within the project, eliminating the need for manual installation.
- Compilation and Building: Facilitates the compilation and building of Node.js projects into a single executable file for simplified deployment.
- Create React Custom Element: Facilitates the creation of react custom element inside Liferay Workspace and fix index.js file to expose a standard web component.
Installation
You can install lr-cx-helper
globally via npm using the following command:
npm install -g lr-cx-helper
Usage - NodeJS Helper
Create NodeJS Client Extension Project
To create a new project using the helper, please use the following command:
lr-cx-helper init-nodejs -n <project-name> -p <optional: target project directory> -t <project-title> -sp <service port>
Building Source Code and Generating CX Project
To build the source code from source code project, run the following npm command inside -source-etc-node:
npm run build
To build the source code from CX project, run the following npm command inside -etc-node:
npm run build-from-source
Compiling
To generate a single executable file for the project, please execute the following command from within the CX project directory "-etc-node".
Compiling CX Project into a Single Executable File (Windows)
To compile the CX project into a single executable file for Windows, use the following npm command:
npm run package-win
Compiling CX Project into a Single Executable File (macOS)
To compile the CX project into a single executable file for macOS, use the following npm command:
npm run package-mac
Compiling CX Project into a Single Executable File (Linux)
To compile the CX project into a single executable file for Linux, use the following npm command:
npm run package-linux
Usage - React Custom Element Helper
To use the helper to create a react custom element, please run the below command inside your Liferay Workspace
LiferayWorkspace / client-extensions /
lr-cx-helper init-react -n <Custom Element Project Name> -t '<Custom Element Title>' -h '<HTML Element Name>' -ic '<include Clay true / false>' -iu '<include Utils true / false>'
Usage - Angular Custom Element Helper
To use the helper to create an angular custom element, please run the below command inside your Liferay Workspace
LiferayWorkspace / client-extensions /
lr-cx-helper init-angular -n <Custom Element Project Name> -t '<Custom Element Title>' -h '<HTML Element Name>'
Usage - Batch Client Extension Helper
To use the helper to create a Batch CX Project, please run the below command inside your Liferay Workspace
LiferayWorkspace / client-extensions /
lr-cx-helper init-batch -n '<Project Name>' -t '<Project Title>'