Android mobile application designed and developed by Sustainable Solutions. Integrates with mSupply to provide accessible and user-friendly temperature monitoring control for medical stock. Open-source and free-to-use, mSupply ColdChain is designed and built with a specific focus on the needs of developing countries.
Currently implemented sensors are the BlueMaestro low-energy bluetooth temperature sensors. Support for additional sensor vendors is underway.
- Track temperatures via bluetooth.
See https://docs.msupply.foundation/en:cold_chain:start for more details of these and many other features.
- Note that these instructions have only been tested on mac OS. If there are any issues you have with different operating systems, please feel free to open an issue.
- Install Android Studio and SDK tools: https://developer.android.com/studio.
- Install SDKMAN for managing Java versions: https://sdkman.io/.
- Install nvm for managing Node versions: https://github.com/nvm-sh/nvm.
- Install yarn for managing Node packages: https://yarnpkg.com/lang/en/.
- Install React Native: https://reactnative.dev/docs/environment-setup. Follow the steps listed under "Building Projects with Native Code" and set Target OS as "Android".
- Clone the repo:
git clone https://github.com/openmsupply/mobile.git
. - Setup local node environment as specified in
.nvmrc
:nvm install && nvm use
. - Install/update app dependencies:
yarn install
.
We welcome contributions from external developers!
- Find a bug or feature you'd like to work on from the issues page, or submit your own. If suggesting a feature, make sure to provide a compelling use case (functionality useful to only one or a few users is unlikely to be approved).
- Comment on the issue to indicate you are interested in working on it.
- Be patient :). A Sussoler will respond with any additional information or questions, and assign you when the issue is ready to be worked on.
- Fork your own copy of the repository.
- Code!
- Open a pull request to the appropriate branch.
- A Sussoler will review your PR and provide comments or request changes.
- Sit back and enjoy the warm glow of success :).
- Ready to contribute? Before opening a PR, do a final check against the following list:
- do all you changes adhered to the Sussol code conventions?
- have you tested all changes you have made for bugs and regressions?
- are your changes consistent with the mSupply Mobile mission statement (basic functionality with a focus on user-friendly and consistent design)?