How to report a bug

If something in the app is not working as it should, please tell us. We honestly want to know. A bug we do not hear about is a bug that stays. Reporting one is a kind thing to do, both for you and for everyone else who might be running into the same problem.

Where to send it

Email help@migraineme.app with the word Bug somewhere in the message. We will pick it up quickly.

What we need to know

The more detail you can give, the faster we can fix it. Please try to include the following. If you do not know the answer to one of them, that is fine. Just leave it out.

1. What you were trying to do. For example, I was trying to log a migraine for yesterday.
2. What happened. For example, When I tapped Save, the app closed and lost what I had typed.
3. What you expected to happen. For example, I expected it to save and go back to the main screen.
4. The steps to make it happen again. For example, Tap the plus button. Tap Migraine. Choose yesterday. Tap Save.
5. Your phone model. For example, iPhone 13 or Samsung Galaxy S22.
6. Your operating system version. We explain how to find this below.
7. A screenshot or short video, if you can. This is hugely helpful.

Finding your phone model and version

On iPhone

1. Open the Settings app (the grey cog).
2. Tap General.
3. Tap About.
4. You will see Model Name and iOS Version near the top.

On Android

1. Open the Settings app.
2. Scroll down to About phone or About device.
3. You will see the model name. Tap Software information for the Android version.

The exact wording varies between Android phones. Look for anything that says About or Software.

How to take a screenshot

A picture of the problem helps us hugely.

On iPhone

1. Press the side button and the volume up button at the same time.
2. The screen will flash.
3. Find the screenshot in the Photos app.

On older iPhones with a home button: home button and side button at the same time.

On Android

1. Press the power button and volume down button at the same time.
2. The screen will flash.
3. Find the screenshot in your Gallery.

How to record a short video

For some bugs, a video shows it better than a picture.

On iPhone

1. Swipe down from the top right corner to open Control Centre.
2. Tap the circle in a circle icon to start screen recording.
3. Open MigraineMe and reproduce the problem.
4. Swipe down again and tap the recording icon to stop.
5. The video saves in your Photos app.

If you do not see the screen recording icon, you can add it. Open Settings, tap Control Centre, and add Screen Recording.

On Android

1. Swipe down twice from the top of the screen to open quick settings.
2. Look for Screen recorder or Screen record and tap it.
3. Open MigraineMe and show the problem.
4. Stop the recording with the floating button or by swiping down again.
5. The video is in your Gallery.

On some Android phones the option may be under Settings instead. If you cannot find it, do not worry. A screenshot will still help.

A simple template you can copy

If you would like a head start, copy this into an email and fill in each line.

Hello, I think I have found a bug. What I was doing: describe it here. What happened: describe it here. What I expected: describe it here. Steps to make it happen again: list them one by one. Phone: your model. Version: your iOS or Android version. My MigraineMe email: the address you sign in with. Thank you, and your name.

What happens after you send it

1. You get a real reply, often within a few hours.
2. We try to reproduce the bug ourselves.
3. If we find it, we fix it. If we cannot reproduce it, we will write back and ask for a bit more help.
4. When the fix is in the next app update, we will let you know.

A small thank-you

Reporting bugs is a real contribution. It helps every user of MigraineMe, not just you. Please do not feel you are being a nuisance. The opposite is true.