diff options
| author |   ARULNA <arul.nambi@amdocs.com> | 2017-06-08 14:35:38 -0400 |
|---|---|---|
| committer | ARULNA <arul.nambi@amdocs.com> | 2017-06-08 14:36:05 -0400 |
| commit | efe884fb213b1272dba67927bf42e64bb3e2fac7 (patch) | |
| tree | 239534bd7a8d5e5c8437ef7966999c245dab723b /README.MD | |
| parent | ca007e933bcd9f63aa77801656ed9dd4142c432c (diff) | |
Adding readme file to the repo
Change-Id: I2330b8ff8fa1ba4bc9abec8228482615db9f3238
Signed-off-by: ARULNA <arul.nambi@amdocs.com>
Diffstat (limited to 'README.MD')
| -rw-r--r-- | README.MD | 50 |
1 files changed, 50 insertions, 0 deletions
diff --git a/README.MD b/README.MD new file mode 100644 index 0000000..f4ccee5 --- /dev/null +++ b/README.MD @@ -0,0 +1,50 @@ +# Sparky - Inventory UI Service
+
+## Overview
+_Sparky_ is a service that interacts with AAI and provides users a UI to view and analyze AAI data. The main goal behind _Sparky_ is providing a more user friendly and clear view of AAI data.
+
+This document covers cloning, installing, and running the front end (FE) portion of _Sparky_.
+
+## Getting Started
+
+### Building the _Sparky_ UI
+
+#### Clone the _Sparky_ FE repository
+
+Repository name is sparky-fe
+
+#### Install required tools
+
+Install node.js, including the Node Package Manager (NPM). Installing latest should be fun, but if that is causing issues then v6.10.1 will work.
+
+Install python, v2.7.13
+
+#### Install required packages
+
+Navigate to the top level project directory and run:
+
+ > npm install
+
+#### Run or Build the Project
+
+To run the project:
+
+ > npm start
+
+By default the local instance of the UI will be served to "https://localhost:8001/aai/#/viewInspect".
+
+This can be configured in the file "webpack.devConfig.js".
+
+To build the project (generates a .war file):
+
+ > gulp build
+
+The build will create a directory called "dist" and add the "aai.war" file into said dist directory.
+
+If changes to the build flow are required, updating "webpack.config.js" and "gulpfile.js" will likely provide any build tuning required.
+
+## Dependencies
+
+_Sparky_ UI requires:
+
+- _Sparky_ instance that will serve the UI
\ No newline at end of file |