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. Connect to the Hosted API Server: This is the easiest and fastest way to get started. You don’t need to set up a local PostgreSQL database or Java API server. This method is lightweight and ideal for contributors who want to focus on the webapp without worrying about backend dependencies.
2. Set Up a Local Development Environment: This involves setting up a local PostgreSQL database and running the Java API server locally. It’s more resource-intensive and complex but may be necessary for certain testing.

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

1. Run make start-with-staging
2. Use the credentials : Username : dummy@osc and Password : dummy@123
3. After logging in please create a new user for yourself and use that .

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.