Contributing to the OWA generator (ReactJs part)

[jeiddiah (Jedidiah Omadoye)]

Hi everyone, I am interested in contributing to the React part of the OWA generator app, but I haven’t been able to find much resources on how to contribute to the repository. However I have setup the generator locally and I have been playing with it for a while, I have also looked at some old and new PR to get a better understanding of the project. Can someone please direct me to resources I could use to better understand the generator, or the issues page so I know what features need to be implemented. Thanks.

cc @ankitkumar @pascal

[pascal (Pascal Brandt)]

Thanks for your interested in contributing! The JavaScript Ecosystem wiki page might be a useful resource. It includes a link to (among others) the OMRSJS JIRA project, which we use for issues relating to the generator. There are not many feature requests at the moment though, so I recommend either creating your own, or pinging this topic to try and extract some requests from the community:

Next Steps For OpenMRS OWA Generator

Hii everyone !! After introducing some new components and setting up a proper testing environment, we are glad that a new version (v0.5.0) of the OWA generator has been published and now we are planning to introduce the FHIR support into the OWA Generator. Me and my mentor (@pascal ) discussed about it and we can introduce an example/demo into the generator to show the use of FHIR. The initial moto for this was to enable the developers who know FHIR (and are unaware of the openmrs API) to set t…

The generator is just a Yeoman implementation, so you can learn what you need to know about development here.

[jeiddiah (Jedidiah Omadoye)]

Thanks pascal.

[ankitkumar]

Hii @jeiddiah Good to see you creating a thread For future also feel free to create threads about any errors or problems you will be facing in case you didn’t get any solution on this thread.

I am providing you some resources as well as some hints on how generator works :

This is the main repository :

psbrandt/generator-openmrs-owa

First of all you should try scaffolding a webapp and deploy it using any openmrs platform whether its sdk or standalone (as you have already setup the generator locally). you can check the deployed app by visiting the OWA module.

For learning the steps to use the yeoman generator, you should visit this as @pascal has already mentioned.

For building apps, you should try setting up your development environment (whatever IDE you like). We use ES6 so you should also have a look at some tutorials on how you can integrate ESLint with your IDE.

Now, I am giving you a brief guide on how generator works :

here the code for our webapps reside. Its the template containing different technologies :

psbrandt/generator-openmrs-owa

Link to a file which contains the code which controls the working of the generator is here

Here you will find the functions which are needed to copy your new react files to the template. Below that you will find more such functions to copy some more things like images, html, etc.

I think that much info will be enough to give you a basic understanding about the generator. If you have some ideas or features in mind, don’t hesitate to post or create ticket about it here. Note : For getting permissions for issues, you need to request the helpdesk. (if you haven’t)

Thanks Have a good day !

[jeiddiah (Jedidiah Omadoye)]

Thanks @antikumar, I’ll look into all this.