Angular Case UI Toolkit
npm install @quickcase/angular-case-ui-toolkityarn # ccd-case-ui-toolkit







``bashInstall all dependencies
yarn install
In your project folder that should consume the library:
`bash
Go to consumer repository folder
cd case-management-webLink you library to the project
yarn link "@quickcase/angular-case-ui-toolkit"yarn start
`Note: The linking might be broken so if your encounter problems please follow this process:
`bash
Install all dependencies
yarn installBuild library in watch mode
yarn build:watch
`In you project folder that should consume the library:
`bash
Go to consumer repository folder
cd case-management-uiRemove existing toolkit dist
rm -rf node_modules/\@quickcase/angular-case-ui-toolkit/distCopy library dist folder to the project
cp /dist node_modules/\@quickcase/angular-case-ui-toolkityarn start
`You can also have a quick look at an example usage of the UI Toolkit demo project (after both folders had
yarn install ran on them) by:
`bash
build UI Toolkit
yarn build:esmcopy UI Toolkit dist folder to demo/node_modules/@hmcts/ccd-case-ui-toolkit/dist
yarn build:demostart demo app and stub server in same process
yarn start
Go to http://localhost:8080
`File Structure
`
case-ui-toolkit
|
├─ src * Library sources home folder
| ├─ components * Example of library components with tests
| ├─ services * Example of library services with tests
| ├─ index.ts * Library entry point that is used by builders
| └─ footers.module.ts * Example of library module
| └─ headers-module.ts * Example of library module
|
├─ .editorconfig * Common IDE configuration
├─ .gitignore * List of files that are ignored while publishing to git repo
├─ .npmignore * List of files that are ignored while publishing to npmjs
├─ .travis.yml * Travic CI configuration
├─ LICENSE.md * License details
├─ README.md * README for you library
├─ gulpfile.js * Gulp helper scripts
├─ karma-test-entry.ts * Entry script for Karma tests
├─ karma.conf.ts * Karma configuration for our unit tests
├─ package.json * yarn dependencies, scripts and package configuration
├─ tsconfig-aot.json * TypeScript configuration for AOT build
├─ tsconfig.json * TypeScript configuration for UMD and Test builds
├─ tslint.json * TypeScript linting configuration
├─ webpack-test.config.ts * Webpack configuration for building test version of the library
├─ webpack-umd.config.ts * Webpack configuration for building UMD bundle
└─ yarn.lock * yarn lock file that locks dependency versions
`Getting Started
Build the library
- yarn build for building the library once (both ESM and AOT versions).
- yarn build:watch for building the library (both ESM and AOT versions) and watch for file changes.You may also build UMD bundle and ESM files separately:
-
yarn build:esm - for building AOT/JIT compatible versions of files.
- yarn build:esm:watch - the same as previous command but in watch-mode.
- yarn build:umd - for building UMD bundle only.
- yarn build:umd:watch - the same as previous command but in watch-mode.Build the library (for CCD devs working on ccd-case-management-web)
For CCD developers it should be noted the library should be built with just the yarn build:esm which is much faster. That will build the JIT version that is currently used by case management web.Other commands
#### Test the library
-
yarn test for running all your *.spec.ts tests once. Generated code coverage report may be found in coverage folder.
- yarn test:watch for running all you *.spec.ts and watch for file changes.Library development workflow
In order to debug your library in browser you need to have Angular project that will consume your library, build the application and display it. For your convenience all of that should happen automatically in background so once you change library source code you should instantly see the changes in browser.
There are several ways to go here:
- Use your real library-consumer project and link your library to it via
yarn link command (see below).
- Use Angular-CLI to generate library-consumer project for you and then use yarn link to link your library to it.$3
You may take advantage of watch-modes for library build in order to see changes to your library's source code immediately in your browser.
To do so you need to:
1. Open two console instances.
2. Launch library build in watch mode in first console instance by running
yarn build:watch (assuming that you're in case-ui-toolkit root folder).
3. Launch your consumer project build (JIT version) in watch-mode by running yarn start in second console instance (for instance assuming that you're in case-management-web folder).As a result once you change library source code it will be automatically re-compiled and in turn your JIT consuming project (e.g. case-management-web) will be automatically re-built and you will be able to see that changes in your browser instantly.
$3
Travis build system automatically publish NPM packages including GitHub releases whenever there is a version change in package.json
Prerelease version from PR branch should follow the format as
x.y.z-RDM-xxx-prerelease`This project is licensed under the MIT License - see the LICENSE file for details.