Simple Docs
  • What is Simple?
    • 📕Background
    • 📱Simple app features
    • 🖥️Dashboard features
    • 👩‍⚕️Who uses Simple?
    • 🏥Clinic workflows
  • Try it out
  • Training materials
  • Contact
    • Contact us
    • Customer support
      • Bug priority definitions
  • Reports
    • What we report
    • Building custom reports
  • Engineering
    • Data dictionary & API
    • Android
      • Conventions
      • Deploying to Play Store
      • Bitrise Workflow Quirks
      • Headers sent from the app
    • Backend
      • Audit logs
      • Major flows
    • Localization
      • Android
      • Server
      • Adding/Editing translations for a project
      • Reviewing a translation
    • Technical Hiring Process
  • Design
    • Design
    • User testing
      • Key moments in the user journey
      • User tests
      • Conducting user tests
  • Onboarding
    • Code of conduct
    • Acronyms
    • Glossary
    • Recommended reading
    • Digital principles
  • Elsewhere
    • Simple.org
    • Source code (GitHub)
Powered by GitBook
On this page
  • How to handle common issues
  • How to report an issue
  • File an "Issue" on Github
  • Filing a useful bug report on Github
  • Additional information, if possible

Was this helpful?

Export as PDF
  1. Contact

Customer support

We appreciate your help in making Simple better for everyone!

PreviousContact usNextBug priority definitions

Last updated 3 years ago

Was this helpful?

How to handle common issues

Praveen Kumar at WHO India has compiled an excellent guide on what program officers should do when healthcare workers encounter issues using Simple:

✋🏽​

How to report an issue

If you use Simple in the field and want to help the tech teams behind Simple with useful bug reports, please reference this helpful guide on how to triage and document issues:

🐞

File an "Issue" on Github

To report a bug, please create an "Issue" on Github. If you don't know what that means, please just email a bug report to with as much information as you can, so we can understand what's happening. Thank you.

📱 File a bug about

🖥️ File a bug about

Filing a useful bug report on Github

  1. Click on New issue

  2. Define the bug succinctly in the title. For example: App freezes when user clicks 'Register as new patient'

  3. In the description, record steps to reproduce the bug.

    1. On the home page, add patient's name, click "Next"

    2. On the next screen, click "Register as new patient"

    3. Behaviour: App freezes

    4. Expected behaviour: Redirect to page where other patient details are requested

  4. Don't forget to label your issue Bug

Additional information, if possible

  • Attach screenshots as supporting documentation

  • Include the app version, device model and Android version in the description

  • For bugs on the Simple Dashboard, include browser and version

What surveillance officers should do when they encounter a bug or issue with the Simple app
How to file a bug report or raise an issue
team@simple.org
the Android app
the web-based Dashboard