https://github.com/msupply-foundation/mobile

Open source mobile app for medical inventory control
https://github.com/msupply-foundation/mobile

Last synced: about 2 months ago
JSON representation

Open source mobile app for medical inventory control

• Host: GitHub
• URL: https://github.com/msupply-foundation/mobile
• Owner: msupply-foundation
• License: other
• Created: 2016-03-17T21:46:35.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2024-01-17T10:02:07.000Z (12 months ago)
• Last Synced: 2024-06-11T15:24:26.199Z (7 months ago)
• Language: JavaScript
• Homepage: http://msupply.org.nz/mobile
• Size: 17 MB
• Stars: 41
• Watchers: 16
• Forks: 26
• Open Issues: 750
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# mSupply Mobile

Cross-platform, offline-first mobile application designed and developed by [Sustainable Solutions](http://sussol.net). Integrates with [mSupply](https://www.msupply.org.nz/) to provide accessible and user-friendly electronic inventory control for medical stock. Open-source and free-to-use, mSupply Mobile is designed and built with a specific focus on the needs of developing countries.

## Features

- Track stock movements and view stock on hand.

- Receive and issue goods with automatic inventory adjustments.

- Order stock from suppliers.

- Forecast required stock based on usage.

- Sync data with a local or remote mSupply server when internet is available.

See [https://docs.msupply.foundation/en:mobile](https://docs.msupply.foundation/en:mobile) for more details of these and many other features.

## Getting started

### Installing mSupply mobile

- Follow the [Prerequisites](../../wiki/Prerequisites) to see the applications, environments or SDKs you would need.

- Follow the [Installation guide](../../wiki/Installation) to set up your development environment.

- Familiarise yourself with our [Git workflow](../..//wiki/Git-workflow) and [coding conventions](../..//wiki/Code-conventions).

### Build and release

- Follow the [Building & Releasing](../../wiki/Building-&-Releasing) guide.

## Contributors

We welcome contributions from external developers!

### How to contribute

1. Find a bug or feature you'd like to work on from the [issues page](https://github.com/sussol/mobile/issues), 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).

2. Comment on the issue to indicate you are interested in working on it.

3. Be patient :). A Sussoler will respond with any additional information or questions, and assign you when the issue is ready to be worked on.

4. Fork your own copy of the repository.

5. Code!

6. Open a pull request to the appropriate branch.

7. A Sussoler will review your PR and provide comments or request changes.

8. Sit back and enjoy the warm glow of success :).

### Checklist

- 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)?