👋 New to our project? Be sure to review the OpenMRS 3 Frontend Developer Documentation. You may find the Map of the Project especially helpful. 🧑🏫
This repository contains frontend modules for the OpenMRS SPA. These modules relate to registering and editing patients, searching for existing patients, creating and managing patient lists, managing patient queues in an outpatient setting and creating, editing and managing patient appointments. The modules within this repository include:
Check out the developer documentation here.
This monorepo uses yarn and lerna.
To install the dependancies, run:
npx lerna bootstrap
To set up environment variables for the project, follow these steps:
- Create a copy of the .env.example file by running the following command:
cp .env.example .env
- Open the newly created .env file in the root of the project.
- Add the environment variables you need.
Note: These variables are currently only used for end-to-end tests.
To start a dev server running all the modules simultaneously, run:
yarn start
This command uses the openmrs tooling to fire up a dev server running esm-patient-chart
as well as the specified module.
Note that this is very resource-intensive.
To start a dev server for a specific module, run:
yarn start --sources 'packages/esm-<insert-package-name>-app'
You could provide yarn start
with as many sources
arguments as you require. For example, to run the patient registration and patient search modules only, use:
yarn start --sources 'packages/esm-patient-search-app' --sources 'packages/esm-patient-registration-app'
If you notice that your local version of the application is not working or that there's a mismatch between what you see locally versus what's in the reference application, you likely have outdated versions of core libraries. To update core libraries, run the following commands:
# Upgrade core libraries
yarn up openmrs @openmrs/esm-framework
# Reset version specifiers to `next`. Don't commit actual version numbers.
git checkout package.json
# Run `yarn` to recreate the lockfile
yarn
Please read our contributing guide.
To run unit tests, use:
yarn test
To run E2E tests, make sure the dev server is running by using:
yarn start
Then, in a separate terminal, run:
yarn test-e2e --headed
Please read our e2e docs for more information about E2E testing.
For documentation about our design patterns, please visit our design system documentation website.
The main
branch of this repo is deployed in a demo environment.
This module is designed to be driven by configuration files.
To increment the version, run the following command:
yarn release
You will need to pick the next version number. We use minor changes (e.g. 3.2.0
→ 3.3.0
)
to indicate big new features and breaking changes, and patch changes (e.g. 3.2.0
→ 3.2.1
)
otherwise.
Note that this command will not create a new tag, nor publish the packages.
After running it, make a PR or merge to main
with the resulting changeset.
Once the version bump is merged, go to GitHub and
draft a new release.
The tag should be prefixed with v
(e.g., v3.2.1
), while the release title
should just be the version number (e.g., 3.2.1
). The creation of the GitHub release
will cause GitHub Actions to publish the packages, completing the release process.
Don't run
npm publish
,yarn publish
, orlerna publish
. Use the above process.