Overview

This project aims to curate and harmonise the JavaScript work being done in the OpenMRS community and facilitate the development of broadly useful tooling.

Projects

The following projects exist in the OpenMRS JavaScript ecosystem.

General Tooling

The JavaScripts projects below are supported by the OpenMRS community and are intended to be general enough to be usable by anyone wanting to build OpenMRS applications using JavaScript.

Open Web Apps Module

The Open Web Apps Module allows developers to build JavaScript/HTML/CSS-only apps that interact with the OpenMRS REST API and have them be statically served using the OpenMRS web application.

Yeoman Generator

The OpenMRS Open Web App Yeoman Generator is able to scaffold out the required boilerplate code and build tooling for an OpenMRS Open Web App. This allows you to get up and running almost instantaneously with building pure JavaScript/HTML/CSS applications on top of the OpenMRS platform.

JavaScript Library

The openmrs.js JavaScript library aims to be a JavaScript wrapper to the REST API with added functionality for common tasks.

Community Contributions

Many community members have already built excellent applications using JavaScript on top of the OpenMRS platform. Please feel free to add your work to this list:

Bahmni: OpenMRS distribution that integrates with other tools that aims to be an out-of-the-box hospital system

Style Guide

OpenMRS uses the following JavaScript style guides.

Linter

Right now we are using ESLint for linting, since it's widely used, the project is highly active and it's very configurable. We recommend that you configure the build to fail on linting errors in order to keep code consistent and of high quality.