{"id":19004913,"url":"https://github.com/dhis2/dhis2-mobile-ui","last_synced_at":"2025-08-02T16:32:42.394Z","repository":{"id":178566537,"uuid":"657609996","full_name":"dhis2/dhis2-mobile-ui","owner":"dhis2","description":"Compose Multiplatfform DHIS2 Mobile UI components library","archived":false,"fork":false,"pushed_at":"2025-04-11T09:29:21.000Z","size":7385,"stargazers_count":12,"open_issues_count":1,"forks_count":5,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-04-17T10:24:47.407Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dhis2.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":"2023-06-23T12:43:00.000Z","updated_at":"2025-01-23T15:21:22.000Z","dependencies_parsed_at":"2023-12-21T18:28:20.674Z","dependency_job_id":"ac0deb5f-3ec2-49d4-8deb-c38efbf66d77","html_url":"https://github.com/dhis2/dhis2-mobile-ui","commit_stats":null,"previous_names":["dhis2/dhis2-mobile-ui"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhis2%2Fdhis2-mobile-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhis2%2Fdhis2-mobile-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhis2%2Fdhis2-mobile-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhis2%2Fdhis2-mobile-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dhis2","download_url":"https://codeload.github.com/dhis2/dhis2-mobile-ui/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250302965,"owners_count":21408503,"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":[],"created_at":"2024-11-08T18:25:18.565Z","updated_at":"2025-04-22T18:50:28.316Z","avatar_url":"https://github.com/dhis2.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DHIS2 Mobile UI\n\nDhis2 Mobile UI library documentation, installation and usage is explained in [DHIS2 Developer portal](https://developers.dhis2.org/docs/mobile/mobile-ui/overview)\n\n## Compose Compiler Reports\n\nThe Compose Compiler plugin can generate reports / metrics around certain compose-specific concepts\nthat can be useful to understand what is happening with some of your compose code at a fine-grained\nlevel.\nYou can read more about\nit [here](https://github.com/androidx/androidx/blob/androidx-main/compose/compiler/design/compiler-metrics.md).\n\nTo generate the reports / metrics, run the following Gradle command\n\n```shell\n./gradlew assembleDebug -PenableComposeCompilerReports=true\n```\n\nThis would generate the output at `\u003cmodule\u003e/build/compose_metrics`\n\n## Screenshot Testing\n\nWe are using [Paparazzi](https://cashapp.github.io/paparazzi/) for screenshot testing.\n\n### Screenshot testing\n\n```kotlin\nclass InputChipSnapshotTest {\n\n  @get:Rule\n  val paparazzi = paparazzi()\n\n  @Test\n  fun launchChip() {\n    paparazzi.snapshot {\n      ColumnComponentContainer {\n        InputChip(label = \"Label\", selected = false, badge = \"3\")\n        InputChip(label = \"Label\", selected = true, badge = \"3\")\n      }\n    }\n  }\n}\n```\n\n### Running tests\n\n`./gradlew designsystem:testDebugUnitTest`\n\nRuns tests and generates an HTML report at `/build/reports/paparazzi/` showing all test runs\nand snapshots.\n\n### Saving golden images to repo\n\n`./gradlew designsystem:recordPaparazziDebug`\n\nSaves snapshots as golden values to a predefined source-controlled location (defaults to\n`/src/test/snapshots`).\n\n### Verifying\n\n`./gradlew designsystem:verifyPaparazziDebug`\n\nRuns tests and verifies against previously-recorded golden values. Failures generate diffs at\n`/build/paparazzi/failures`.\n\n# Documentation\n\nThe Mobile UI documentation is integrated in the [developer portal](https://developers.dhis2.org/). It \nuses [Docusaurus](https://docusaurus.io), a modern tool to build documentation pages.\n\nThe documentation is written in Markdown. The sidebar is automatically generated based on the metadata \nof the different files. It follows the rules explained in the [autogenerated sidebar docs](https://docusaurus.io/docs/next/sidebar/autogenerated#autogenerated-sidebar-metadata). \nIn short, every file must have a `sidebar_position` label at the beginning of the document, which \ndefines the position of the document relative to its folder. Then, each folder has a `_category_.yml` \nfile, which has a `position` property defining the position of that folder relative to its parent folder.\n\nIt is possible to nest as many folders as desired following that pattern.\n\n## Testing\n\nIt is possible to build the Developers portal documentation to test your changes.\n\nSteps to test:\n1. Do the changes in the Mobile UI docs and push them to a branch in github.\n2. Download the [Deverlopers portal repository](https://github.com/dhis2/developer-portal).\n3. Change the branch in the Mobile UI block in the file `docs-migrate.js` to point to your branch.\n4. Follow the instructions in [CONTRIBUTING](https://github.com/dhis2/developer-portal/blob/main/CONTRIBUTING.md) \nto build the docs.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdhis2%2Fdhis2-mobile-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdhis2%2Fdhis2-mobile-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdhis2%2Fdhis2-mobile-ui/lists"}