Skip to main content

Migraine Navigator: Patient Guide

Data-driven tracking and analysis.

What is Migraine Navigator?​

Migraine Navigator is a desktop application designed to help you track, analyze, and predict your migraine attacks. It correlates your symptom logs with local weather data and lifestyle habits to identify potential patterns.

Key Features​

1. The Risk Dashboard​

  • Live "Tomorrow Risk": See a gauge (e.g., "70% Risk") for tomorrow based on the weather forecast and your recent sleep/activity.
  • 24-Hour Plan: A detailed hourly chart shows exactly when the risk is highest (e.g., "Peak risk at 2:00 PM due to pressure drop").

2. Smart Logging​

  • One-Tap Entry: Log medications and triggers in seconds.
  • Pain Slider: An intuitive visual slider makes logging simple, even during an attack.
  • Privacy First: Your location is automatically detected for weather accuracy, but never tracked or saved.

3. Personalized & Improving Model​

The app builds a custom AI model — just for you — that gets smarter every time you log.

  • First 60 Logs ("Cold Start"): Uses your onboarding sensitivity settings (Weather, Sleep, Stress) to provide immediate estimates from Day 1.
  • Log 60+: Switches to a personal Gradient Boosting AI that detects your unique patterns (e.g., "You only get migraines on Tuesdays when it rains").
  • Ongoing — "Model Update Ready": As you continue logging, the app detects when enough new data exists to improve your model. The Dashboard shows a "Model Update Ready" button. One tap retrains the AI in the background — the app stays fully responsive while it works.

Why keep logging? Every entry makes your personal model more accurate. The prediction you get on Day 365 is measurably better than the one you got on Day 60.

4. Data Import​

Already have migraine history from another app or a previous device?

  • CSV Import: Upload a .csv file exported from any spreadsheet or health app.
  • Database Import: Restore from a previous Migraine Navigator .db backup.
  • Duplicate entries are automatically detected and skipped — no need to worry about importing the same file twice.

Getting Started​

Installation​

  1. Download the latest release for macOS.
  2. Open the app and follow the "Onboarding" guide to set your baseline sensitivity (Are you very sensitive to weather? sleep?).

Your First Week​

  • Log Daily: Try to log once a day, even if you feel fine (logging "No Pain" is just as important!).
  • Check the Graph: Look at the dashboard in the morning to see if you need to take extra care today (e.g., drink more water, sleep earlier).

Privacy Promise​

Your data stays on your Mac. We do not have servers. We cannot see your logs. You are the only person who owns your health data.