Bahmni Connect Development

AngularJS requires the following tool tree installed on your development machine.

• Xcode (only for mac)
• Ruby
• Node v10.11.0
• Yarn
• Project specific node modules

Use following instructions (the exact mechanism for doing step 1 would depend on the OS you are using, we have mentioned for mac).

1. Install Xcode and yarn
2. Install the following modules required globally (This is a one time task)bash

   gem install compass

3. Checkout the bahmni-connect repository on GitHubYou would have to run the following commands for Bahmni Connect front end project. Run these commands from the ui folder under Bahmni Connect front end projectbash

   # Install dependencies (Installed node dependencies into node_modules. UI dependencies are installed in node_modules/@bower_components and create a soft link to app/components).
   yarn install

4. Checkout the bahmni-offline repository on GitHub. (Only require for android app)
5. Run this command from Bahmni connect front end project folder for creating a symlink into your vagrant /var/www:bash

   # links dist folder
   ./scripts/vagrant-link.sh

Chrome App (PWA):

• To bundle PWA, run the following commands from ui folder under Bahmni Connect front end projectbash If you want to debug Connect PWA on your local machine, you should run "yarn devchrome" which will put unminified js files onto the "bahmni-connect/ui/dist/" location.

  # To genearte css files
  yarn compass
  
  # To minify and bundle PWA related source code
  yarn chrome
  
  # To generate service workers files
  yarn sw

• To access bahmni-connect apps on chrome hit https://<host name>/bahmni-connect

Android App:

• Checkout the&nbsp;bahmni-offline&nbsp;repository on GitHub. (Only require for android app)
• Follow the steps recommended&nbsp;in the&nbsp;README.md file of&nbsp;bahmni-offline project
• To bundle Android app,&nbsp;run the following commands from&nbsp;ui folder under Bahmni Connect front end projectbash

  # To genearte css files
  yarn compass
  
  # To minify and bundle android app related source code
  yarn android

• Copy&nbsp;dist folder of&nbsp;bahmni-connect/ui&nbsp;folder to&nbsp;bahmni-offline/android/www/app
• Run the following command from&nbsp;bahmni-offline/android&nbsp;to&nbsp;install the android app on the device (The device should be connected to the system).bash

  ionic run android