{"id":22451451,"url":"https://github.com/openmrs/openmrs-esm-home","last_synced_at":"2025-04-12T19:45:00.681Z","repository":{"id":35141593,"uuid":"203839620","full_name":"openmrs/openmrs-esm-home","owner":"openmrs","description":"The homepage microfrontend for the OpenMRS SPA","archived":false,"fork":false,"pushed_at":"2025-03-06T20:26:59.000Z","size":9341,"stargazers_count":16,"open_issues_count":4,"forks_count":78,"subscribers_count":49,"default_branch":"main","last_synced_at":"2025-04-03T22:09:22.145Z","etag":null,"topics":["microfrontend","openmrs","react","spa","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/openmrs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-08-22T17:11:42.000Z","updated_at":"2025-02-27T08:53:18.000Z","dependencies_parsed_at":"2024-01-30T19:12:25.015Z","dependency_job_id":"6c7e96d3-c794-4ae9-a177-565dc4c5c83e","html_url":"https://github.com/openmrs/openmrs-esm-home","commit_stats":{"total_commits":141,"total_committers":29,"mean_commits":4.862068965517241,"dds":0.8085106382978724,"last_synced_commit":"2e7f81b7239565084408715820216549e8cd5892"},"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openmrs%2Fopenmrs-esm-home","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openmrs%2Fopenmrs-esm-home/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openmrs%2Fopenmrs-esm-home/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openmrs%2Fopenmrs-esm-home/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openmrs","download_url":"https://codeload.github.com/openmrs/openmrs-esm-home/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248625490,"owners_count":21135513,"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":["microfrontend","openmrs","react","spa","typescript"],"created_at":"2024-12-06T06:08:00.930Z","updated_at":"2025-04-12T19:45:00.652Z","avatar_url":"https://github.com/openmrs.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":":wave: *New to our project? Be sure to review the [OpenMRS 3 Frontend Developer Documentation](https://o3-docs.openmrs.org/docs/introduction)*.\n\n![Node.js CI](https://github.com/openmrs/openmrs-esm-home/actions/workflows/node.js.yml/badge.svg)\n\n# OpenMRS ESM Home\n\nAn [OpenMRS Microfrontend](https://openmrs.atlassian.net/wiki/spaces/projects/pages/26936899/OpenMRS+3.0+A+Frontend+Framework+that+enables+collaboration+and+better+User+Experience) for the O3 Home page.\n\n## What is this?\n\nopenmrs-esm-home is an in-browser [javascript module](https://github.com/openmrs/openmrs-rfc-frontend/blob/master/text/0002-modules.md) \nthat is a [single-spa application](https://single-spa.js.org/docs/building-applications.html). It is responsible for rendering the UI for the landing page after the user logs in.\n\n## Contributing / Development\n\nCheck out the developer documentation [here](https://o3-docs.openmrs.org/docs/frontend-modules/development).\n\nThis monorepo uses [yarn](https://yarnpkg.com/).\n\nTo install the dependencies, run:\n\n```bash\nyarn\n```\n\nTo start a dev server for the home app, run:\n\n```bash\nyarn start --sources 'packages/esm-home-app'\n```\n\n## Running tests\n\nTo run all tests, run:\n\n```bash\nyarn turbo run test --filter=@openmrs/esm-home-app\n```\n\nTo run a specific test file, run:\n\n```bash\nyarn turbo run test -- \u003ctest-file-name\u003e\n```\n\nThe above command will only run tests in the file or files that match the provided string.\n\nTo generate a `coverage` report, run:\n\n```bash\nyarn turbo run coverage\n```\n\nBy default, `turbo` will cache test runs. This means that re-running tests without changing any of the related files will return the cached logs from the last run. To bypass the cache, run tests with the `force` flag, as follows:\n\n```bash\nyarn turbo run test --force\n```\n\n## Troubleshooting\n\nIf 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 [dev3](https://dev3.openmrs.org/openmrs/spa), you likely have outdated versions of core libraries. To update core libraries, run the following commands:\n\n```bash\n# Upgrade core libraries\nyarn up openmrs@next @openmrs/esm-framework@next\n\n# Reset version specifiers to `next`. Don't commit actual version numbers.\ngit checkout package.json\n\n# Run `yarn` to recreate the lockfile\nyarn\n```\n\n## Design Patterns\n\nFor documentation about our design patterns, please visit our [design system](https://om.rs/o3ui) documentation website.\n\n## Configuration\n\nPlease see the [Implementer Documentation](https://wiki.openmrs.org/pages/viewpage.action?pageId=224527013) for information about configuring modules.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenmrs%2Fopenmrs-esm-home","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenmrs%2Fopenmrs-esm-home","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenmrs%2Fopenmrs-esm-home/lists"}