🧠 Cluster Headache Tracker Android

Cluster Headache Tracker Android is a Hotwire Native wrapper for the Cluster Headache Tracker web application. This app uses Hotwire Native for Android to provide the web app experience within a native Android app shell.

🎯 Purpose

The main reason for creating this Android app is to increase accessibility and visibility of the Cluster Headache Tracker. While the web application functions as a Progressive Web App (PWA), many users are unfamiliar with PWAs or how to add them to their home screens. This native Android wrapper provides a familiar way for users to download and access the app through the App Store.

🚀 Features

• 📱 Access the Cluster Headache Tracker web app through a familiar Android app interface
• 📊 View and interact with headache logs and charts
• 🔒 Secure authentication and data storage (handled by the web app)

🔢 Versioning

• Local builds fall back to the checked-in app version in app/build.gradle.kts
• Tag releases derive versionName from the Git tag and versionCode from semver
• Example: v2.1.1 builds as versionName=2.1.1 and versionCode=20101

🛠 Requirements

• Android 9 (API level 28)
• Android Studio

📲 Installation

1. Clone the repository:

   git clone https://github.com/crmne/cluster-headache-tracker-android.git
   

2. Open the folder in Android Studio

3. Build and run the project on your Android device or simulator.

🔗 Related Projects

• Cluster Headache Tracker (Web): The main web application that this Android app wraps.

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for more details on how to get started.

📄 License

Cluster Headache Tracker Android is released under the GNU General Public License v3.0 (GPL-3.0).

🔒 Privacy

This Android app provides access to the same web application as the browser version, maintaining the same privacy principles. No additional personally identifiable information is collected or stored. All data handling occurs on the EU-based servers of the main Cluster Headache Tracker application.

🍕 Support the Project

If you find this tool valuable, please consider making a donation:

🆘 Support

If you encounter any issues or have questions, please open an issue on GitHub.

🙏 Acknowledgements

• Hotwire Native for Android for enabling this web-to-native wrapper.
• All contributors and users who help improve this project.