Hey all!
I've just finished another joyful cycle of episodic cluster headaches, and during some downtime i've put together a headache tracker / pain logging app. It's extremely bare-bones at the moment, and when i say app - its a web app that runs in browser. This is a personal open source effort to help other sufferers, not a commercial project and all data is stored locally in your own instance, no cloud, no central hosting.
Without getting into the technical details at this point - would anyone else find this useful?
Im looking to get some feedback or requests for the app - as i've built out what i find useful, but im sure others have differing experiences and I want to build something that caters for as many of us as possible.
The project lives here: https://github.com/OliPassey/headache-tracker/tree/Mongo (Including screenshots)
Im working on a fork of the original code i wrote a while ago (and is awful), and i don't recomend trying to install this just yet. Im happy to help you set things up if you're interested in having a version running, but you will need a certain level of tech knowledge to get it going at the moment. (Docker, MongoDB, Caddy)
On first run of the app a setup process will ask a load of questions and allow you to configure nearly all aspects of the app. Medications, Abortives and Symptoms are all custom to you, the app starts with none and asks you to add everything. The app is also designed in dark mode only, due to photosensitivity issues, customizing the colour palette is hopefully coming soon.
The workflow of the app currently is;
On first signs of an attack, click "Start New Headache"
This will log start time, pain level 0 (for graph cleanliness) and issue a headache ID for tracking
You should then log your pain changes as often as needed on the 0 - 10 buttons.
There are then sections for logging Medication, Abortives & Symptoms.
Medication will likely move out of this section as its intended as a med log on a daily basis outside of an individual headache
Abortives allow you to monitor how effective each method is, and report on Oxygen Tank status (On/Off currently) should you use it.
Symptoms allows you to log your common symptoms as they happen.
Once the attack is over, pain is down to zero and if using oxygen, Oxygen Off has been logged - click "End Headache"
A report is instantly available, that looks like this;
What i'm working on currently;
Improving graphing & reporting.
Export for Medical Professional option - will detail who you are, and summarize data as well as providing raw output.
Carer's Realtime dashboard. inc. Pain Level, Symptoms, Abortives, Oxygen Status etc.
Future Goals
Potentially notifications or email output to aid in removing data from the system
Making set up as easy as possible, as close to 1-click as possible.
Packaging all components together to reduce setup complexity (MongoDB, WebApp, Front-End)
Warning: If you do try and get this code running, do not make it available to the public internet! It is not a secure app in its out of the box config, and should only be available on your local network or via VPN / ZeroTier etc.
That ended up being longer than expected - thoughts?