Readme

You will need yarn package mananger to be installed globally to run this project. Follow the instructions on https://yarnpkg.com/en/docs/install to install yarn if it is not already installed on your machine. Once installed you can verify it by running yarn -v on terminal. It should return whatever is the latest version mentioned on https://yarnpkg.com/en/docs/install.

Install dependencies

Once yarn is installed run the following:

make deps

Setup

There are two possible ways to setup Avni Webapp for developement:

1. You can setup the webapp in a way that it directly connects to the hosted API server so you don't have to setup local postgres database and Java API server. This is an easy way to get started as you don't have to worry about having to install Java and API Server. Also this will consume less resources on your system as you are not running API server.
2. You can setup local postgres database and API server also locally and connect the webapp to that server. This is more difficult as it involves having to install Postgres, Java and running Java API Server.

1. Setup to connect to hosted API Server (Samanvay hosted staging server)

1. Create a file named .env.development.local in root directory of avni-webapp
2. Put the below content in this file:

REACT_APP_COGNITO_IN_DEV=true
REACT_APP_AWS_REGION=ap-south-1
REACT_APP_COGNITO_USER_POOL_ID=ap-south-1_hWEOvjZUH
REACT_APP_COGNITO_APP_CLIENT_ID=7dbsrgg56mptr4ue1g65nv3s86

3. Set the value of "proxy" field in package.json to "https://staging.avniproject.org".
4. Run make start
5. It will start the app on http://http://localhost:6010/. It will ask you for login. If you dont' know the credentials ping us on #openchs channel on Gitter.

2. Setup to connect to your local API Server

1. Start your Java Server. For this refer to product developement setup document.
2. Run make start in avni-webapp directory.
3. It will assume whatever user you started the Java Server with since we don't do authentication when running the server locally. If you want to change the user then restart the webapp after setting environment variable REACT_APP_DEV_ENV_USER to user you want. E.g. start the server like REACT_APP_DEV_ENV_USER=ihmp-admin make start.

Contributing

Pull requests

• Please make sure that your code follows guidelines given in https://avni.readme.io/v2.0/docs/contribution-guide.

File/folder structure

• There are multiple apps inside this repository
  • Admin (Allow admins to do admin work like creating organisations, users, locations)
  • App Designer (Allow admins to design the app)
  • Reports (Allow admins to download longitudnal reports)
  • Translations (Allow admins to upload translations)
  • Data Entry App (Allow users to do data entry using web based app)
• Folders per route/feature (See https://marmelab.com/blog/2015/12/17/react-directory-structure.html)
• Reducers and actions in 'ducks' structure (See https://github.com/erikras/ducks-modular-redux). This is not applicable for App Designer as it does not use Redux.

Code Style

• We use Prettier for javascript/jsx formatting. You can use your IDE/Editor specific Plugin to format code using Prettier. Alternatively there is also a command make prettier-all that will format all files in src folder using Prettier. And there also is a git precommit hook that formats staged files using prettier before commiting.

Continuous Integration

All commits are built and tested and deployed to staging if tests succeed. Build status can be seen at https://circleci.com/gh/OpenCHS/openchs-webapp. Please run tests using make test before you push your code so you don't end up breaking things unnecessarily.