Cluster Headache Tracker is a free, open-source web application designed to help individuals suffering from cluster headaches track and manage their condition. By providing detailed logging, visual insights, and easy sharing with healthcare providers, this tool aims to improve the understanding and treatment of cluster headaches.
demo.mp4
Visit https://clusterheadachetracker.com to create a free account and start tracking your cluster headaches.
- 📝 Detailed Logging: Record intensity, duration, triggers, and medications for each headache episode.
- 📊 Visual Insights: Gain valuable insights with interactive charts and graphs showing your headache patterns over time.
- 🩺 Share with Doctors: Generate shareable reports to collaborate effectively with your healthcare providers.
- 💾 Data Import/Export: Easily import and export your headache logs in CSV format for backup or analysis.
- 🔒 Secure & Private: Your health data is encrypted and stored securely, with full control over sharing.
- 🕵️ Privacy-Focused: We don't store any personally identifiable information. Users are identified by a username, not an email address.
- 🇪🇺 EU-Based: Our servers are hosted in Germany, ensuring compliance with strict EU data protection regulations.
- 📱 Mobile Friendly: Access your tracker on any device with our responsive, mobile-friendly design.
- 🌟 Open Source: Contribute to the development and customize the tracker to fit your needs.
- Ruby 3.3.4
- PostgreSQL
-
Clone the repository:
git clone https://github.com/crmne/cluster-headache-tracker.git cd cluster-headache-tracker -
Install dependencies:
bundle install -
Set up the database:
rails db:create rails db:migrate -
Set up environment variables: Create a
.envfile in the root directory and add the following variables:RAILS_MASTER_KEY=your_master_key POSTGRES_PASSWORD=your_database_password HONEYBADGER_API_KEY=your_honeybadger_api_key -
Start the development server:
bin/dev -
Visit
http://localhost:3000in your browser to see the application running locally.
To run the test suite:
rails test
rails test:system
This project uses Kamal for deployment. To deploy:
- Set up your deployment configuration in
config/deploy.yml. - Run:
kamal deploy
We welcome contributions! Please see our Contributing Guide for more details on how to get started.
Cluster Headache Tracker is released under the GNU General Public License v3.0 (GPL-3.0).
We take your privacy seriously. Cluster Headache Tracker does not collect or store any personally identifiable information. Users are identified by a username only, not an email address. All data is stored on servers located in Germany, ensuring compliance with strict EU data protection regulations.
If you find this tool valuable, please consider making a donation:
If you encounter any issues or have questions, please open an issue on GitHub.
Thank you to all the contributors and users who help make this project better every day.