UNPKG

@c8y/apps

Version:

Cumulocity IoT applications

84 lines (61 loc) 3.32 kB
# @c8y/apps The application package (`@c8y/apps`) provides example applications for the Web SDK. ## Getting started To use the @c8y/apps you need to install the [@c8y/cli](https://www.npmjs.com/package/@c8y/cli). Refer to its documentation for installation instructions. Once installed you can run: ``` $ c8ycli new [your-app-name] [example-name] ``` For example, to generate the tutorial application with the name `my-app` you need to run: ``` $ c8ycli new my-app tutorial ``` The `c8ycli new` command can also be provided on its own without the `[name]` and `[template]` options. In this case a few steps will have to be completed via the interface before the app is scaffolded: **Step 1:** ``` ? Enter the name of the project: (my-application) ``` The first step will ask for the project name. If no project name is entered, the default value `my-application` will be used. > **Info:** This step can also be skipped if the name is provided in the initial command: `c8ycli new my-application`. **Step 2:** ``` ? Which base version do you want to scaffold from? (Use arrow keys) > 1010.0.X (latest) > 1011.X.0 (next) > 1011.0.X > 1009.0.X > 1007.0.X > 1006.0.X > other ``` In the second step, the base scaffolding version must be selected. The interface will provide the last GA release (latest), the latest available release (next) and four older GA releases. Additionally a version can be manually entered by selecting the `other` option. **Step 2 (other):** ``` ? Enter the desired version: ``` In this step, the desired version must be entered manually e.g. `1010.0.0`. > **Info:** This question will appear only if `other` was selected in the previous step. **Step 3:** ``` ? Which base project do you want to scaffold from? administration application cockpit devicemanagement hybrid tutorial widget-plugin ``` In the final step, the base project to scaffold from must be selected. > **Info:** This step will only show projects which are available for the selected version in Step 2. ## Included applications The following table provides an overview on the currently supported applications: | Name | Description | | ---- | --- | |`application`| An empty application to quickly bootstrap new applications. It is the default application and used if you don't specify an `[example-name]`.| |`hybrid`| Also an empty application but running in hybrid mode. That means it can import angularjs plugins and therefore can be used for migration purpose. | |`tutorial`| An application that already assembles most of the concepts of the [@c8y/ngx-components](https://www.npmjs.com/package/@c8y/ngx-components). Use this to get real code examples. | |`widget-plugin`| An Module Federation plugin that can be used to create your own custom widgets. | |`cockpit`| The [Cockpit](http://www.cumulocity.com/guides/users-guide/cockpit/) default application. Use this to extend the existing Cockpit application. | |`devicemanagement`| The [Devicemanagement](http://www.cumulocity.com/guides/users-guide/devicemanagement/) default application. Use this to extend the existing Device Management application. | |`administration`| The [Administration](http://www.cumulocity.com/guides/users-guide/administration/) default application. Use this to extend the existing Administration application. |