Environment setup for front end product development - Ubuntu

This page documents, how to set up your development machine so that you can contribute to Sakhi2.0 front-end code - mobile app or webapp. This assumes that you have access to some test Sakhi2.0 server, with one or more implementations deployed, to which you can connect to from your development environment. If you want to set up a full-stack environment, please use this.

This setup documentation assumes that the user knows how to install and use some of the commonly used utilities. There is enough documentation on the Internet for installing and using them (putting in your version of Ubuntu would give you better results). We may link these docs in some places but not always. The exact commands are indicated as this always. Please ensure you have the following software setup.

• Git
• Github account
• You OS user has sudo access
• Curl
• nvm
• (Optional) Automatically set node version when you change your directory based on the .nvmrc file present in that directory. Place the function code as it in the file.

Other information

The Github organisation for Sakhi2.0 is here - Link which has all the repositories.

Field mobile app components

Android SDK

Install Android SDK Manager
Use SDK Manager to install - platforms;android-28 and build-tools;28.0.3
Set ANDROID_HOME environment variable
Modify PATH to include $ANDROID_HOME/tools and $ANDROID_HOME/tools/bin
Android Emulator
Install Genymotion or Android studio.
Create a virtual android device and start it
Sakhi2.0 Android Client
Clone Sakhi2.0-client from Github
Use nvm to install node version requires - nvm install from the Sakhi2.0-client directory. It would pick up the .nvmrc file to install the correct version.
Install node dependencies - make deps (this would take some time in installing all the node dependencies)
Verify unit tests are running fine - make test
cp packages/openchs-android/config/env/dev.json.template packages/openchs-android/config/env/dev.json
Modify the value of SERVERURL in _packages/openchs-android/config/env/dev.json file to match your Sakhi2.0 server.
From the Sakhi2.0-client folder, perform make run_app and then press sync button in the app. This should download all the configuration and master data that has been set up for this implementation.

Web app components

Clone Sakhi2.0-web-app
Run nvm install from root dir of Sakhi2.0-web-app (to install the required node version)
Install Yarn. Instructions here
make deps start (ensure that you have started the server by providing the user)
Open the app by going to http://localhost:6010
To start the web app as a specific user like admin@jnpct or dev@jnpct you can run - REACT_APP_DEV_ENV_USER=admin@jnpct make start or REACT_APP_DEV_ENV_USER=dev@jnpct make start

SETUP COMPLETE !!!