cumulocity-hello-plugin-modular

A boilerplate to start writing Cumulocity UI plugin with a taste of modular structure.

Why?

This boilerplate is basically a twin of cumulocity-ui-plugin-examples and a sibling to cumulocity-smart-apps-webpack: it exists for similar reasons. ;)

Installation

• Make sure you have Node.js LTS installed and npm from its website, or better even, use nvm.

• Install yarn.

• Install cumulocity-tools.

• Clone the repo, cd to your project directory.

• Adapt the UI build version you want to develop against:

$ c8y install [ui_build_version]

• Install dependencies:

$ yarn install:clean

Usage

Check out the introduction to plugin development docs.

Quicky up and running

Oh well, I know that you guys are a bunch of lazy people. How to get this app deployed and see it running on my tenant, you ask? Be my guest:

$ yarn deploy

After a few more steps in interactive command line user interfaces, you should then be able to access the app on https://<your-tenant-url>/apps/helloapp.

Unit testing

$ yarn test

Linting

$ yarn lint <target_file_or_dir>

Example:

$ yarn lint plugins

Or better yet, make your IDE automatically integrate the linting process based on the .rc file (.eslintrc).

The rules quite strictly follow the Airbnb JavaScript Style Guide (ES6+ without React).

Author

Glenn Dwiyatcita (@dwiyatci)

License

MIT.

See LICENSE.txt.