Liquid Prep - App

Liquid Prep App is an user interface that is accessed on your mobile device to get water advise for the selected crop. It is a Progressive Web App (PWA) developed with Angular web framework.

The Liquid Prep App gets the Weather and Crops data from the Liquid Prep Backend service and the soil moisture data from the Liquid Prep Hardware. After analysis of the weather, crop and soil moisture data the app computes and provides water advise for the selected crop.

The Liquid Prep App can be run on your local machine for development and testing purpose. And it is deployed on IBM Cloud Object Storage for production to be accessed globally.

Click to access Liquid Prep App

Get Started

Instructions on how to run the App,

• Pre-requisites
• Run App Locally
• Configure and Deploy App in IBM Cloud Object Storage
• Contributing

Pre-requisites

1. Node and NPM:
   • Install Node and NPM
2. Angular CLI
   • Install Angular CLI
3. Git:
   • Install Git
   • Configure Git
   • Git account setup and configuration
4. Liquid Prep project:
   • Git clone Liquid Prep project
5. IBM Cloud account:
   • Create an IBM Cloud account
6. Liquid Prep Backend Service Endpoint:
   • Deploy Liquid Prep Backend in IBM Cloud Functions and note down the CLOUD_FUNCTIONS_URL which is the Backend service endpoint. This endpoint will be required later for deploying the App.

Run App Locally

1. Build the App

   • Start a terminal/CMD in LiquidPrep-App/liquid-prep-app folder.
   • Run npm install.

2. Config.json

   • In the LiquidPrep-App/liquid-prep-app/src/ folder, rename the file config-sample.json to config.json.
   • Update the config.json with Liquid Prep Backend Service Endpoint noted down in the Pre-requisites 6th point.

3. Run the App

   • Run npm start.
   • Open the browser and enter http://localhost:4200/. The app will automatically reload if you change any of the source files.

   NOTE: You can also run the App by executing Angular CLI command ng serve too.

Configure and Deploy the App in IBM Cloud Object Storage

The Liquid Prep App can be built and deployed in production for accessing the endpoint URL in any browser (recommended Chrome) to spin up the App in the browser.

Please follow the step wise instructions in the IBM Cloud Deployment Documentation.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, areas where we'd like to see community contributions, and the process for submitting pull requests to the project.

License

Unless otherwise noted, this project is licensed under the Apache 2 License - see the LICENSE file for details.