Wiki Spaces

Documentation
Projects
Resources

Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack

Projects

Page tree
Skip to end of metadata
Go to start of metadata

We're building a new frontend for OpenMRS via a collaborative process that leverages modern frontend technologies. These technologies will enable OpenMRS users and developers around the world to share more frontend functionality, reduce duplicated effort, and have a better user experience. 15-min overview video of the vision here.

Quick Links

Here are the most important links for this project, aside from the actual code. High-level project documentation and information about how to Join Us can be found below.

view DEMO SITE u: admin p: Admin123

Project Documentation

screen O3 Implementer Guide lightbulb O3 Designer Guide code O3 Dev Guide

Where to Find Work

checkbox Live Tickets Dashboard   backlog Team Jira Board   branch Key GitHub Repos

Designs Ready for Development*

world Public: Patient Chart   new-edit Detailed: Patient Chart

world Public: OHRI Package   new-edit Detailed: OHRI Package

  world Public: Offline   new-edit Detailed: Offline


 *  Note: the Detailed links require an invite to our OpenMRS Zeplin project. Just let us know if you require an invite. 

How to Work with the Designs

video-filled Zeplin how-to for devs   gallery Styleguide (re-useable shared components & more)


(lightbulb)

Why OpenMRS 3? 

Wondering how we got here?

See: A Visual History of the OpenMRS Frontend

Github Logo - Free social media icons

Looking for a repo?

See the Dev Guide's Repositories You Should Know. 


Project Overview

We are working on 3 main goals that will unlock better frontend collaboration across OpenMRS:

(1) Plug-and-Play Frontend Architecturemakes it possible for frontend feature development to be shared across teams, organizations, and distributions

(2) Implementer Tooling: makes it easier for non-developers to configure the product to the needs of their organization or site

(3) A friendly, modern, consistent User Experience: with a professional UX framework, this further unlocks frontend feature-sharing, and creates a 3.0 option of the OpenMRS RefApp


O3 Resources to Know

OpenMRS 3 Explained


Coming Soon


Developer Guide


code O3 Dev Guide


Code Repositories


code O3 Code Repos


Github Logo - Free social media icons


Connect With Us

Online

Weekly 3.x Product Design Call

What: A weekly gathering of BAs, PMs, Designers and stakeholders co-designing 3.x workflows and features. We share emerging ideas, detailed requirements, discuss concerns, and review the latest design outputs and user testing results. 

When: Mondays at 4pm UTC / 9:30pm IST/ 7pm EAT / 5pm CEST / 11am EST / 8am PST  (GCal link here)

video-circle Zoom link: om.rs/zoommf

edit Call Notes & Recordings

Weekly 3.x Squad Call (all-hands)

What: Our weekly 3.x initiative all-hands. Everyone (Devs, Designers, BAs/PMs) shares their updates, and a short design showcase is shared to keep everyone current on the latest design thinking and user feedback. 

Thursdays at 3pm UTC / 8:30pm IST/ 6pm EAT / 4pm CEST / 10am EST / 7am PST  (GCal link here)

video-circle Zoom link: om.rs/zoommf

edit Call Notes & Recordings


Want to contribute? Join our squad! 

  1. Review the high-level guidance on this page
  2. Dev Guide: Use our Dev Guide to get started. Look for answers there.  info Dev Guide  If you are still unsure about a question, double check the short videos in the Dev Tutorials, and make sure you're familiar with the MF Tooling tutorial  and the MF Extensions Tutorial. If you are still stuck after double-checking the Dev Guide for answers, ask our squad in the #microfrontends slack channel.
  3. Intro: Introduce yourself at our Squad #microfrontends Slack channel (Note: You will first need to create an OpenMRS Slack account by going to slack.openmrs.org)
  4. Find Intro Tickets: Intro tickets you can use to start contributing are available here:  checkbox Open Issues to Get Started This dashboard shows the latest Intro and Non-Intro tickets that need to be taken on to support the MicroFrontend work. This also shows the different features (via Epics) that are currently underway. 
    1. Note: To view the designs in detail, you'll need an invite to our Zeplin account. Ask Grace Potma& Eric Achillah for help - @grace & @Eric on Slack. Make sure you also review our short How to Use Zeplin video.
    2. Please assign tickets to yourself before starting work. This helps avoid confusion and accidental duplication of work. Double-check the ticket's Epic for other related work before working on things outside the described scope of the ticket - you may accidentally be replicating a feature someone else is already working on.
    3. Please only take 1-2 tickets at a time. This helps you to focus on getting 1-2 things done at a time. If you assign yourself to multiple tickets, this prevents others from working on them, so please be considerate of others and only pick up 1-2 tasks at a time. When those are done, you can assign yourself another 1-2 other tasks. If you have submitted your PR for 2 tickets and are still waiting for feedback, it is okay to pick up another ticket, so long as you promptly respond to the feedback on your original tickets so that work can be merged promptly.
  5. Meet Us! Join our weekly Squad calls on Thursdays (info under Where You Can Find Us above) (GCal invite here). 
  6. Sprints: Become part of our regular sprints. This will happen naturally as you join our calls, though you don't need to join all calls in order to participate. Here is our active board. We use epics to break down features and widgets, and we typically work in 3-week sprints.  board Active Sprint Board backlog Squad Backlog & Sprints




Information Below


Status

VERY ACTIVE

Background

Strategic Fit for OpenMRS

video-filled Why Microfrontends?

info High-Level Strategy

info SPA Proposal Explained

info Detailed Technical Vision

Decision Making Process

We use an RFC (Request For Comments). Major decisions are made through GitHub pull requests where anyone can comment.

info OMRS Frontend RFC


Where can you find us ?

On Slack

Slack Channel: https://openmrs.slack.com/archives/CHP5QAE5R

(Join our Weekly Calls to become part of our focused OpenMRS 3.0 Squad) 

Weekly Squad Call

Thursdays at 4pm UTC / 9:30pm IST/ 7pm EAT / 5pm CET / 11am EST / 8am PST.

 Join info: https://om.rs/zoommf

What Happens On These Calls:

  1. Dev Demo: latest work done (if it’s the end of a sprint, we also do the full sprint demo)
  2. Dev Discussion: Any blockers or things to clarify
  3. Product Priorities: We clarify any epics or issues that need more ownership or to be prioritized
  4. Design Updates: We wrap up by looking together at the latest design work, so we know what designs are soon to be ready for development 

Recordings and Notes from our regular squad meetings are here: 3.x Squad Notes

Team

Project Owners:

Jonathan Dick (AMPATH)

Grace Potma (OpenMRS)

Dimitri R (Mekom Solutions)

Burke Mamlin(Regenstrief Institute)

UX Design:

Ciarán Duffy (Sonder Design & AMPATH)

Paul Adams (Sonder Design & AMPATH)

Software Architecture:

Florian Rappl (Smapiot & Mekom Solutions)

Brandon Istenes (PIH)

Developers, DevOps, QA, BA: 

Nikita Malyschkin  (Smapiot & Mekom Solutions)

Dennis Kigen  (AMPATH)

Donald Kibet (AMPATH)

Emmanuel Nyachoke (Mekom Solutions)

Eudson Bambo(UCSF)

Samuel Male (UCSF)

Amos Laboso(UCSF)

Romain Buisson  (Mekom Solutions)

Mike Seaton (PIH)

Daniel Kayiwa (OpenMRS)

Eric Achillah (AMPATH, PM & QA)

Jonathan Teich (BA/Clinical feedback)

Ian Bacher (Brown) (Backend & FHIR support)

Bett Kipchumba (AMPATH) (Backend & FHIR support)

More Information

(1) Plug & Play Architecture: The frontend stack we're building on using Micro Frontends

Goal: Frontend architecture designed for extensible and configurable apps and widgets.

What are Microfrontends? Microfrontends are in-browser javascript modules (ESMs) that provide application UI. They make it possible to have extensible, configurable and independently deployable frontend features. It means you can get your frontend live and updated fast

Our MF Framework is Single-SPA: We chose to use single-spa, the most popular microfrontends framework, as the basis upon which to build this new frontend architecture.

Our MF Tech Stack: Primarily React, HTML and CSS, but it's not unfeasible that one could choose to develop in a JavaScript framework of their choosing - that's the whole premise behind microfrontends after all.


video-filled Tutorial

configure GitHub: esm-core

info Dev Guide


(2) Implementer Tooling: Tooling we're building to make MFE easier for implementers to configure

Goal: Enable both developers and non-developers to easily configure their distribution, and re-use that configuration rapidly. 


video-filled Demo

configure Implementer Tool App on GitHub   openmrs-esm-implementer-tools-app is an in-browser javascript module provides a UI for viewing and editing configurations, and viewing other administrative information about the frontend application. It is part of the Extension System.

configure Implementer Config Library on GitHub This is the configuration library for OpenMRS Microfrontends. It makes configurability easier for developers and configuring easier for implementers.



(3) Building a Friendly, Modern UX in RefApp v3.0

Goal: Create a better means for building out a shared UI. Modernizing the entire RefApp frontend, using Carbon Design System for UI consistency and faster dev value. Our OpenMRS Reference Application needs to become a Point of Care application, that’s modern, friendly, and works well on tablets. 



We are working on a re-design of the patient chart, starting with end-to-end support for HIV Outpatient Workflows.

We're currently in the process of implementing new designs that leverage the carbon design system for our reference application. (More on why we chose carbon here).

We're not starting from scratch though. Rather, we're migrating from an old set of designs (and an old style guide) to the new designs (and now migrating to use Carbon Design System as well - not all the Carbonizing work is done). As such, it should not be unexpected that gaps will be found in documentation, incomplete implementations, broken functionality and so on as we move to get everything back in order.

Designs:

new-edit Designs Ready for Development

time Designs in Progress

Our Design System:

info Carbon Design System

info Rationale for Carbon

Our Simple Style Guide for reference:

camera Styleguide (Re-useable Styled Components)

video-filled How to Use Zeplin in Dev Work