- Dart 98.3%
- C++ 0.7%
- CMake 0.5%
- Kotlin 0.3%
Glicemia 🩸
A privacy-first, cross-platform blood glucose tracking application built with Flutter. Designed for personal health monitoring, statistical analysis, and seamless integration with Android Health Connect.
✨ Key Features
- 📊 Comprehensive Tracking: Log glucose readings with timestamps, notes, and measurement sources (CGM, fingerstick, laboratory).
- 📈 Advanced Statistics: Real-time calculation of Time in Range (TIR), Glucose Management Indicator (GMI), standard deviation, and hypo/hyper event counts.
- 🔄 Health Connect Integration: Securely import glucose data directly from compatible Android health applications. Filter by source app and select specific data fields.
- 📄 Professional PDF Reports: Generate structured, accessible, and clinically formatted PDF reports for personal archiving or healthcare provider review.
- 🐍 Python & R Shell: Built-in desktop terminal for advanced data analysis. Features syntax highlighting, persistent command history (
~/.glicemia_shell_history), and configurable safety timeouts. - 🔒 Local-First & Encrypted: All health data is stored locally with AES-256-GCM encryption. Zero telemetry, zero cloud dependencies, zero third-party trackers.
- 🌐 Cross-Platform: Runs natively on Android, Linux, Windows, macOS, and Web (WebAssembly-ready for optimal browser performance).
📱 Platform Support
| Platform | Status | Notes |
|---|---|---|
| Android | ✅ Stable | Requires Android 9+. Health Connect requires Android 14+ or the companion app |
| Linux | ✅ Stable | Full desktop experience with native Python/R shell support |
| Web | 🚧 Beta | Compiles to JS & WebAssembly. All data stored in local browser storage |
| Windows | 🚧 Alfa | Shell requires Python/R added to system PATH |
| macOS | 🚧 Alfa | Native support. HealthKit integration planned for future releases |
🚀 Getting Started
For Users
- Android: In the future it will be possible to download the latest APK from the Releases page or install via F-Droid.
- Desktop: In the future it will be possible to download the appropriate
.AppImage(Linux),.exe(Windows), or.dmg(macOS) from the releases section. - Web: In the future it will be possible to access the live build. Runs entirely in your browser with local storage.
For Developers
# Clone the repository
git clone https://codeberg.org/nur/glicemia.git
cd glicemia
# Install dependencies
flutter pub get
# Run in debug mode
flutter run
📖 See DEVELOPMENT.md for detailed setup instructions, testing guidelines, and build commands.
🔒 Privacy & Security
Glicemia is engineered with a privacy-first architecture:
- 🗄️ Local Storage: Your health data never leaves your device. No accounts, no cloud sync, no external APIs.
- 🔐 AES-256-GCM Encryption: Sensitive data is encrypted at rest using hardware-backed keystores where available.
- 📡 Zero Telemetry: No analytics, crash reporting, advertising, or tracking libraries are included.
- 🛡️ Open Source: Fully auditable codebase. F-Droid compatible with reproducible builds.
📖 Usage Overview
| Feature | How to Access | Description |
|---|---|---|
| Dashboard | Home screen | View recent readings, trend indicators, and quick-add functionality |
| Statistics | Stats tab | Access detailed metrics, historical trends, and estimated HbA1c |
| Health Connect Import | Settings > Import Data |
Authorise and sync from compatible Android health apps. Filter by source package and select fields |
| PDF Export | Dashboard or Settings | Generate clinical-ready reports with patient info, statistics, and recent readings |
| Advanced Shell (Desktop) | Settings > Advanced Tools |
Enable Python/R REPL. Commands are saved to history with ↑/↓ navigation and a configurable safety timeout |
🤝 Contributing
Contributions are warmly welcome! Please read our Development Guide for:
- Project architecture & file structure
- Testing strategies & Fake class patterns (Dart 3 compatible)
- Code style & linting rules
- Pull request workflow & commit conventions
The project is fully compliant with F-Droid guidelines. I welcome translations, accessibility improvements, new data source integrations, and documentation enhancements.
📄 License
This project is licensed under the GNU General Public License v3.0.
You are free to use, modify, and distribute the software, provided that derivative works remain open-source under the same licence.
🙏 Acknowledgements
- Built with Flutter & Dart
- Health Connect integration via the
healthpackage - PDF generation powered by
pdf&printing - Syntax highlighting by
highlight - Inspired by open-source health tracking initiatives and clinical best practices for diabetes management
⚠️ Medical Disclaimer: Glicemia is designed for personal tracking and educational purposes only. It does not replace professional medical advice, diagnosis, or treatment. Always consult a qualified healthcare provider regarding blood glucose management and therapeutic decisions.