Page Comparison

Steps to follow when installing the OpenMRS Password Reset Open Web App for the first time.

...

1. You will need NodeJS 6+ installed to do this. See the install instructions here.

2. Once you have NodeJS installed, install the dependencies (first time only):

   npm install

3. Build the distributable using Webpack as follows:

   npm run build:prod

4. This will create a file called openmrspasswordresetui.zip file, which can be uploaded to the OpenMRS Open Web Apps module.

Local Deploy

To deploy directly to your local Open Web Apps directory, run:

...

This will build and deploy the app to your local Open Web Apps directory. To change the deploy directory, edit the LOCAL_OWA_FOLDER entry in config.json. If this file does not exists, create one in the root directory that looks like:

{ "LOCAL_OWA_FOLDER": "path to your local Open Web Apps directory" }

Live Reload

To use Browersync to watch your files and reload the page, inject CSS or synchronize user actions across browser instances, you will need the APP_ENTRY_POINT entry in your config.json file:

{
  "LOCAL_OWA_FOLDER": "path to your local Open Web Apps directory",
  "APP_ENTRY_POINT": "http://localhost:8080/openmrs/owa/openmrspasswordresetui/index.html"
}

Run Browsersync as follows:

...

• Set the mail.user property to the email account which would serve as the email sender for your password reset emails. In my system, the email sender is openmrspr@gmail.com as seen in the above picture.

• Set the mail.password property to the password of the email account you inputed in the previous line. This grants the server access to that email account, and the ability to use that email account to send password reset emails.
• Set the other properties exactly as seen in the picture (Ensure you set the mail.default_content_type to text/html. This is crucial to enabling the server send the email, which is an html template).
• Finally, set the host.url property(not found in the picture) to http://localhost:8080/openmrs/owa/openmrspasswordresetui/index.html#/resetPassword/{activationKey} . 
• Save and exit the page, your system should now be able to send password reset emails properly.

...