# cumulocity-smart-apps-webpack > A boilerplate for creating Cumulocity Smart Apps instance using webpack-dev-server 3.x Latest version **3.1.1** (published 2018-05-17) · MIT license · 0 weekly downloads ## Install ```sh npm install cumulocity-smart-apps-webpack pnpm add cumulocity-smart-apps-webpack yarn add cumulocity-smart-apps-webpack bun add cumulocity-smart-apps-webpack ``` ## Health **Score 5/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support. Negative: insecure dependencies; abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 3.1.1 | | Published | 2018-05-17 | | First published | 2016-08-17 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 6 | | Unpacked size | 6.8 MB | | Known vulnerabilities | 0 (+5 in 1 direct dependencies) | | Install scripts | no | | GitHub stars | 0 | | Author | Glenn Dwiyatcita | | Maintainers | dwiyatci | | Keywords | cumulocity, m2m, examples, demo, boilerplate, cumulocity smart apps, cumulocity webpack, cumulocity toolkit | ## Links - npm: https://www.npmjs.com/package/cumulocity-smart-apps-webpack - Repository: https://github.com/dwiyatci/cumulocity-smart-apps-webpack - Issues: https://github.com/dwiyatci/cumulocity-smart-apps-webpack/issues - npm.io page: https://npm.io/package/cumulocity-smart-apps-webpack ## Dependencies (6) - [angular-route](https://npm.io/package/angular-route.md) 1.5.11 - [babel-runtime](https://npm.io/package/babel-runtime.md) 6.26.0 - [babel-polyfill](https://npm.io/package/babel-polyfill.md) 6.26.0 - [bootstrap-sass](https://npm.io/package/bootstrap-sass.md) 3.3.7 - [angular-ui-bootstrap](https://npm.io/package/angular-ui-bootstrap.md) 2.5.6 - [cumulocity-clients-javascript](https://npm.io/package/cumulocity-clients-javascript.md) git+https://github.com/Cumulocity/cumulocity-clients-javascript.git ## Alternatives - [lodash.assign](https://npm.io/package/lodash.assign.md) — 2.3M weekly downloads - [lodash.chunk](https://npm.io/package/lodash.chunk.md) — 1.8M weekly downloads - [react-native-ios-utilities](https://npm.io/package/react-native-ios-utilities.md) — 138.5K weekly downloads - [@technically/lodash](https://npm.io/package/@technically/lodash.md) — 50.9K weekly downloads - [@fluid-topics/ft-icon](https://npm.io/package/@fluid-topics/ft-icon.md) — 20.6K weekly downloads ## Recent versions - 3.1.1 (latest) — 2018-05-17 - 3.1.0 — 2018-01-07 - 3.0.0 — 2017-10-31 - 2.0.3 — 2017-05-16 - 2.0.2 — 2017-05-14 - 2.0.1 — 2017-05-14 - 2.0.0 — 2017-05-14 - 1.0.2 — 2016-08-20 - 1.0.1 — 2016-08-17 - 1.0.0 — 2016-08-17 ## README # cumulocity-smart-apps-webpack [![version](https://img.shields.io/npm/v/cumulocity-smart-apps-webpack.svg)](https://www.npmjs.com/package/cumulocity-smart-apps-webpack) [![downloads](https://img.shields.io/npm/dt/cumulocity-smart-apps-webpack.svg)](http://npm-stat.com/charts.html?package=cumulocity-smart-apps-webpack) [![MIT License](https://img.shields.io/github/license/mashape/apistatus.svg)](https://raw.githubusercontent.com/dwiyatci/cumulocity-smart-apps-webpack/master/LICENSE.txt) A boilerplate to conveniently start creating Cumulocity Smart Apps instance and to improve development experience with webpack 3.x. ![Screenshot](screenshot.png) ## ~~ATTENTION: Cumulocity Smart Apps Toolkit is currently in legacy mode as it is based on the old release of UI core JS API (6.3.x). That said, you may still use it and it's up to you to decide whether it works and still well-suited for your particular app.~~ [cumulocity-clients-javascript](https://github.com/Cumulocity/cumulocity-clients-javascript) a.k.a. Cumulocity Smart Apps Toolkit a.k.a. Cumulocity [Web SDK for AngularJS](https://www.cumulocity.com/guides/web/smart-toolkit/) seems to be brought back to life (8.x). It's kinda form of [necromancy](http://www.urbandictionary.com/define.php?term=Necromancy) but I'd still recommend you to [develop plugins](http://cumulocity.com/guides/web/introduction/) as it offers more out-of-the-box features and more convenient for newbs. ### Why? I would like to enhance [the current boilerplate](https://bitbucket.org/m2m/cumulocity-examples/src/fa8077ade64ddb74100296742e739daa258ae9b3/hello-core-api/?at=default) for creating a Cumulocity Smart Apps instance in order to be able to: - have a cleaner development boilerplate which highly respects some awesome style guides ([John Papa's Angular 1 Style Guide](https://github.com/johnpapa/angular-styleguide/blob/master/a1/README.md), [Airbnb JavaScript Style Guide](https://github.com/airbnb/javascript)). - leverage package managing and bundling process by getting rid of Bower* and Grunt in favour of npm and webpack. - showcase the usage of ES6+ in my code in conjunction with AngularJS. - use npm (scripts) as a build tool. - improve developer experience with webpack-dev-server 3.x (Code Splitting, Caching, HMR, Tree Shaking, Scope Hoisting, etc.). - stop repeating the hustle of creating a fiddle of CSA instance when I'm doing support for the guys who are still using the toolkit (yes, **you**! :yum:). *~~Unfortunately there are some package dependencies which are only available in Bower, including [the toolkit](https://bower.io/search/?q=cumulocity-clients-javascript) itself. So, I cannot migrate 'em all completely to npm. :disappointed:~~ ## Usage - Install Node.js and npm from its [website](https://nodejs.org), or even better: use [nvm](https://github.com/creationix/nvm). - Install [yarn](https://yarnpkg.com/en/docs/install). - Checkout the repo, `cd` to project directory, and setup dependencies: ```bash $ yarn install:clean ``` * For development, start webpack development server with hot reloading capability: ```bash $ yarn start ``` You'll find the CSA instansce running on https://localhost:8080. * For production, build frontend static assets: ```bash $ yarn build ``` Simply drop all files under `assets` directory to your production server. ### Deploying to a Cumulocity tenant - Build the assets: `yarn build`. - Zip all files under `assets` directory (:warning: not the directory itself!) and name the ZIP file as "smartapps" or whatever you want to call the app. - Go to Administration → Own applications → Add application → Upload ZIP file, then drop the app ZIP file from the previous step. ## Author Glenn Dwiyatcita ([@dwiyatci](http://tiny.cc/dwiyatci)) ## License MIT. See [LICENSE.txt](LICENSE.txt). --- _Source: https://npm.io/package/cumulocity-smart-apps-webpack · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._