{"id":15904106,"url":"https://github.com/dermatologist/openmrs-owa-react-boilerplate","last_synced_at":"2026-01-21T16:35:40.361Z","repository":{"id":28577431,"uuid":"118772057","full_name":"dermatologist/openmrs-owa-react-boilerplate","owner":"dermatologist","description":"An OpenMRS OWA Template Using React and Redux. ","archived":false,"fork":false,"pushed_at":"2022-12-02T19:35:26.000Z","size":2682,"stargazers_count":2,"open_issues_count":12,"forks_count":1,"subscribers_count":3,"default_branch":"develop","last_synced_at":"2025-02-13T23:31:33.040Z","etag":null,"topics":["emr","openmrs","react-redux","reactjs"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dermatologist.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-01-24T13:54:22.000Z","updated_at":"2021-11-07T09:51:17.000Z","dependencies_parsed_at":"2023-01-14T09:05:50.349Z","dependency_job_id":null,"html_url":"https://github.com/dermatologist/openmrs-owa-react-boilerplate","commit_stats":null,"previous_names":[],"tags_count":4,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dermatologist%2Fopenmrs-owa-react-boilerplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dermatologist%2Fopenmrs-owa-react-boilerplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dermatologist%2Fopenmrs-owa-react-boilerplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dermatologist%2Fopenmrs-owa-react-boilerplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dermatologist","download_url":"https://codeload.github.com/dermatologist/openmrs-owa-react-boilerplate/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247737786,"owners_count":20987721,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["emr","openmrs","react-redux","reactjs"],"created_at":"2024-10-06T12:21:27.287Z","updated_at":"2026-01-21T16:35:40.330Z","avatar_url":"https://github.com/dermatologist.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://cloud.githubusercontent.com/assets/668093/12567089/0ac42774-c372-11e5-97eb-00baf0fccc37.jpg\" alt=\"OpenMRS\"/\u003e\n\n# openmrs-owa-react-boilerplate\n\nThis is aboilerplate for creating React with Redux \nOpen Web Apps in OpenMRS. This is an extension of the react-redux boilerplate project\nstarted by [@djazayeri](https://github.com/djazayeri/openmrs-owa-reactexample)\n\n# Conceptual Diagram\n![OpenMRS OWA React](https://raw.github.com/dermatologist/openmrs-owa-react-boilerplate/master/docs/owa-react.png)\n\n# How to use this template \n\n* change 'prescription' to 'your-app-name'\n* Update manifest.webapp\n\n\n# openmrs-owa-prescription\nThis repository contains the Prescription OpenMRS Open Web App.\n\n\u003e Add a description of what your app does here.\n\nFor further documentation about OpenMRS Open Web Apps see\n[the wiki page](https://wiki.openmrs.org/display/docs/Open+Web+Apps+Module).\n\n## Development\n\n### Production Build\n\nYou will need NodeJS 4+ installed to do this. See the install instructions [here](https://nodejs.org/en/download/package-manager/).\n\nOnce you have NodeJS installed, install the dependencies (first time only):\n\n```sh\nnpm install\n```\n\nBuild the distributable using [Webpack](https://webpack.github.io/) as follows:\n\n````sh\nnpm run build:prod\n````\n\nThis will create a file called `prescription.zip` file in the `dist` directory,\nwhich can be uploaded to the OpenMRS Open Web Apps module.\n\n### Local Deploy\n\nTo deploy directly to your local Open Web Apps directory, run:\n\n````\nnpm run build:deploy\n````\n\nThis will build and deploy the app to the `/Users/user/openmrs/prescription/owa/`\ndirectory. To change the deploy directory, edit the `LOCAL_OWA_FOLDER` entry in\n`config.json`. If this file does not exists, create one in the root directory\nthat looks like:\n\n```js\n{\n  \"LOCAL_OWA_FOLDER\": \"/Users/user/openmrs/openmrs-owa-prescription/owa/\"\n}\n```\n\n### Live Reload\n\nTo use [Browersync](https://www.browsersync.io/) to watch your files and reload\nthe page, inject CSS or synchronize user actions across browser instances, you\nwill need the `APP_ENTRY_POINT` entry in your `config.json` file:\n\n```js\n{\n  \"LOCAL_OWA_FOLDER\": \"/Users/user/openmrs/prescription/owa/\",\n  \"APP_ENTRY_POINT\": \"http://localhost:8080/openmrs/owa/prescription/index.html\"\n}\n```\nRun Browsersync as follows:\n\n```\nnpm run watch\n```\n\n### Extending\n\nInstall [npm](http://npmjs.com/) packages dependencies as follows:\n\n````sh\nnpm install --save \u003cpackage\u003e\n````\n\nTo use the installed package, import it as follows:\n\n````js\n//import and assign to variable\nimport variableName from 'package';\n````\n\nTo contain package in vendor bundle, remember to add it to vendor entry point array, eg.:\n\n````js\nentry: {\n  app : `${__dirname}/app/js/owa.js`,\n  css: `${__dirname}/app/css/owa.css`,\n  vendor : [\n    'package',\n    ...//other packages in vendor bundle\n  ]\n},\n````\n\nAny files that you add manually must be added in the `app` directory.\n\n### Troubleshooting\n\n##### [HTTP access control (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS)\n\nYou may experience problems due to the `Access-Control-Allow-Origin` header not\nbeing set by OpenMRS. To fix this you'll need to enable Cross-Origin Resource\nSharing in Tomcat.\n\nSee instructions [here](http://enable-cors.org/server_tomcat.html) for Tomcat 7 and [here](https://www.dforge.net/2013/09/16/enabling-cors-on-apache-tomcat-6/) for Tomcat 6.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdermatologist%2Fopenmrs-owa-react-boilerplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdermatologist%2Fopenmrs-owa-react-boilerplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdermatologist%2Fopenmrs-owa-react-boilerplate/lists"}