Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
reagan-meant authored Oct 7, 2024
1 parent 13f9730 commit 9b85061
Showing 1 changed file with 20 additions and 34 deletions.
54 changes: 20 additions & 34 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,46 +1,32 @@
![Node.js CI](https://github.com/openmrs/openmrs-esm-template-app/workflows/Node.js%20CI/badge.svg)
# OpenMRS 3.x IPS ESM

# OpenMRS ESM Template App
A frontend module for downloading and viewing International Patient Summaries (IPS) in O3.

This repository provides a starting point for creating your own
[OpenMRS Microfrontend](https://wiki.openmrs.org/display/projects/OpenMRS+3.0%3A+A+Frontend+Framework+that+enables+collaboration+and+better+User+Experience).
The IPS can be viewed in the patient chart when you navigate to the Patient summary page.

For more information, please see the
[OpenMRS Frontend Developer Documentation](https://o3-docs.openmrs.org/#/).

In particular, the [Setup](https://o3-docs.openmrs.org/docs/frontend-modules/setup) section can help you get started developing microfrontends in general. The [Creating a microfrontend](https://o3-docs.openmrs.org/docs/recipes/create-a-frontend-module) section provides information about how to use this repository to create your own microfrontend.

## Running this code
## Getting Started for developers

```sh
yarn # to install dependencies
yarn start # to run the dev server
```
# Clone the repository
git clone [email protected]:openmrs/openmrs-esm-ips.git

Once it is running, a browser window
should open with the OpenMRS 3 application. Log in and then navigate to `/openmrs/spa/root`.
# to install dependencies
yarn

## Adapting the code
# to run the dev server
yarn start

1. Start by finding and replacing all instances of "template" with the name
of your microfrontend.
2. Update `index.ts` as appropriate, at least changing the feature name and the page name and route.
3. Rename the `root.*` family of files to have the name of your first page.
4. Delete the contents of the objects in `config-schema`. Start filling them back in once you have a clear idea what will need to be configured.
5. Delete the `greeter` and `patient-getter` directories, and the contents of `root.component.tsx`.
6. Delete the contents of `translations/en.json`.
7. Open up `.github/workflows` and adapt it to your needs. If you're writing
a microfrontend that will be managed by the community, you might be able to
just replace all instances of `template` with your microfrontend's name.
However, if you're writing a microfrontend for a specific organization or
implementation, you will probably need to configure GitHub Actions differently.
8. Delete the contents of this README and write a short explanation of what
you intend to build. Links to planning or design documents can be very helpful.
# OR to start on a specified port eg 5000
yarn start --port 5000
```

At this point, you should be able to write your first page as a React application.
Once it is running, a browser window should open with O3 running. Log in and then navigate to the patient chart under the Patient Summary.

Check out the [Medication dispensing app](https://github.com/openmrs/openmrs-esm-dispensing-app) for an example of a non-trivial app built using the Template.
## Running tests

## Integrating it into your application
```sh
yarn run test
```

Please see [Creating a Frontend Module](https://o3-docs.openmrs.org/docs/recipes/create-a-frontend-module).
# Dependencies
This esm depends on this backend module [See [here](https://github.com/I-TECH-UW/openmrs-module-ips)]

0 comments on commit 9b85061

Please sign in to comment.