GSoC 2023: O3: Migrate vanilla React forms to RHF

Primary Mentor
Backup Mentor
Assigned to 


Currently OpenMRS  has a bunch of forms written in O3 in vanilla React. These forms, though functional, are not the most performant or extensible and for the most part, lack validation. React Hook Form offers easy-to-use validation out of the box, performance and tiny bundle size. The task is to refactor existing forms to use the React Hook Form library as well as Zod for schema validations.

Required Skills

          • Excellent  React, Typescript, HTML , CSS skills
          • Experience with or desire to learn about refactoring

Project Rating and length


175 hours


      • To refactor the existing forms in the application using the ReactHookForm library.
      • To introduce schema validation using the Zod library.
      • To improve form performance and maintainability.
      • Simplify form development and reduce the amount of boilerplate code required.

Identified forms to Refactor

There are
9 forms  that this refactor targets which include: 

                    • Conditions form >>>>>1
                    • Programs form>>>2
                    • Allergy from >>>>>3
                    • Start Visit form >>>>>
                    • Visit Notes form >>>>>
                    • Appointments form >>>>
                    • Vitals and Biometrics form >>>>>>
                    • Medication Order form >>>>>
                    • Patient Registration (heaviest lift, written in Formik) >>>>>


              1. Identify Forms to Refactor:
              2. Install and Configure RHF and Zod:
              3. Create RHF Form Components
              4. Integrate Zod for Schema Validation:
              5. Migrate Existing Form Data:
              6. Test and Debug:



Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.

Weekly Reports/blogs

Find all of them at :

Bonding period:

week 01:

week 02:

week 03:

week 04:

week 05:

week 06:

Mid-term evaluation:

week 07:

week 08:

week 09:

week 10:

week 11:

week 12:

Final Presentation


OpenMRS 3.0: A Frontend Framework that enables collaboration and better User Experience