OCL client for OpenMRS is a web service that will allow OpenMRS users to manage their concepts on the web, allow reusability of the existing concepts and allow one to create their concepts if they are not in exsitance.
- To download NodeJS and Npm click here. OR To install Node.js and Npm via package manager click here
Npm is distributed with Node.js- which means that when you download Node.js, you automatically get npm installed on your computer.
- Fork the repository by clicking on the Fork button located below the navigation bar on the right side of the page.
- Clone the forked repository to your computer ensure to run the command below in the directory you want to store the project.
# git clone [the url of the repository] For example;
# git clone https://github.com/yourusername/openmrs-ocl-client.git
- In the root directory of the project install all the dependencies using the command below
$ npm install.
- After installing all the dependencies:
- Run the command below to start the server
npm start
- The site should now be running at http://localhost:3000/ in the browser where you will see the app, You can change the port to your wish.
- Modify scripts part of package.json and add the port you want to use:
1. For MacOs or Linux:
"start": "PORT=3006 react-scripts start"
2. For Windows:
"start": "set PORT=3006 && react-scripts start"
For instances where port 3000 is being used it will prompt you to reply with letter Y to change the port automatically.
Our environments are running in docker.
Ensure you have docker installed and running locally. Install docker from here.
- Fork the repository by clicking on the Fork button located below the navigation bar on the right side of the page.
- Clone the forked repository to your computer and ensure to run the command below in the directory you want to store the project.
$ git clone [the url of the repository] For example:
$ git clone https://github.com/yourusername/openmrs-ocl-client.git
- Build the Docker image using the provided Dockerfile in the root folder.
$ docker build -t openmrs/ocl-client:local .
- Run the docker image using docker-compose
$ docker-compose -f docker/docker-compose.yml up -d
- Navigate to your http://localhost:8081/
Your should now see your app running :)
To run tests
$ npm test -- -u --coverage
- Please read OpenMRS wiki for awareness on the code of conduct used in OpenMRS organization
- And to get you started with the project please use the OpenMRS-OCL documentation
Talk to us on OpenMRS Talk