Diabetes Tracker Web App

A simple and personal web app to track:

• Blood glucose readings
• HbA1c lab results
• Diabetic supplies (e.g., insulin, test strips)

Built using Python, Streamlit, Pandas, and Matplotlib.

---

🚀 Live App

Click here to view the live app!

---

📚 Table of Contents

• Features
• Tech Stack
• Folder Structure
• First Setup
• About
• Resetting Data
• What's New
• Future Plans and Ideas
• Roadmap
• Development Progress
• Need Help or Have Ideas
• Contributing
• Acknowledgements

---

📋 Features

• Add new glucose readings manually
• Add HbA1c lab results
• Import glucose readings from CSV files
• View graphs for glucose trends and HbA1c
• Manage diabetic supplies inventory
• Download and upload data easily
• An example import_me.csv file is included in the examples/ folder.
• You can use it to practice importing glucose readings into the app.

---

🛠 Tech Stack

• Streamlit
• Pandas
• Matplotlib
• GitHub

---

📂 Folder Structure

glucose_tracker/
├── .github/                    # GitHub configurations (contact form, issue templates)
├── .streamlit/                 # Streamlit settings (favicon, title)
├── pycache/                # Python cache (auto-generated)
├── data/                       # Active working data (user input)
│   ├── glucose_readings.csv
│   ├── hba1c_readings.csv
│   └── supplies.csv
├── example/                    # Example file for importing
│   └── import_me.csv
├── templates/                  # Blank template CSVs
│   ├── glucose_readings_template.csv
│   ├── hba1c_readings_template.csv
│   └── supplies_template.csv
├── main.py                     # CLI tool (optional legacy use)
├── requirements.txt            # Python package dependencies
├── reset_data.py               # Script to reset data from templates
├── streamlit_app.py            # Main Streamlit frontend app
├── utils.py                    # Core backend logic
├── .gitignore                  # Files to exclude from Git tracking
├── CHANGELOG.md                # Version-by-version changelog
├── CODE_OF_CONDUCT.md          # Community standards
├── CONTRIBUTING.md             # How to contribute
├── LICENSE                     # Project license
├── README.md                   # Project overview
├── RELEASE_NOTES.md            # Detailed release version notes
└── SECURITY.md                 # Security guidelines and vulnerability reporting

---

📥 First Setup

When first cloning or using the app:

• The real working data is located in the data/ folder.
• If you prefer to start fresh, copy the blank templates from the templates/ folder into the data/ folder.
• Templates include:
  • glucose_readings_template.csv
  • hba1c_readings_template.csv
  • supplies_template.csv

✅ This ensures the app has the correct structure even if no readings have been entered yet.

---

👨‍💻 About

This project was built to help manage diabetes more easily — track important readings, monitor trends, and keep your supplies organized, all from one simple app.

---

🔄 Resetting Data

To reset your app's data back to a clean state (blank templates):

1. Open your terminal inside the project folder.
2. Run:

python reset_data.py

*Built with love using Python and Streamlit.*

 
🆕 What's New

Version 1.2 (Current)

- TBC

Version 1.1 (Current)

- 🎯 Moved working data to `/data/` folder
- 📂 Added `/templates/` folder with blank CSV templates
- 🔄 Added `/examples/` folder with sample import files
- 🛠 Added `reset_data.py` script to reset working data easily
- 🚀 Improved README structure and project documentation
- 🖼️ Added custom Streamlit app favicon and page title
- 📥 Setup First Time Instructions for new users

---

 Version 1.0 (Current)

- ✅ Initial launch of Diabetes Tracker web app
- ✅ Record blood glucose readings
- ✅ Record HbA1c results
- ✅ Track diabetic supplies
- ✅ Import glucose readings via CSV
- ✅ View graphs for glucose trends and HbA1c trends
- ✅ Full deployment to Streamlit Cloud

[View full Release Notes ➡️](RELEASE_NOTES.md)

## 🔮 Future Plans and Ideas

We have lots of exciting features planned to make the Diabetes Tracker even more helpful!

- 📥 Import HbA1c results via CSV (not just manual entry)
- 📤 Export blood glucose and HbA1c graphs as images
- 🔒 Optional user login for better privacy
- 📅 Reminders and notifications for logging glucose and supplies
- 📈 Daily, weekly, and monthly reports generation
- 🖼️ Customizable dashboard themes (light/dark mode)
- 📱 Mobile-friendly layout improvements
- 📊 Add trendlines or prediction models for glucose data
- 🌓 Dark Mode toggle for nighttime use
- ☁️ Google Sheets or OneDrive backup integration
- 📬 Email reminders for overdue readings
- ⚡ Set personal glucose targets and alerts
- 📈 Add basic analytics (average glucose, variability trends)

*Have more ideas? Feel free to [open an Issue](https://github.com/mattyhakin/glucose_tracker/issues/new/choose) and suggest!*

## 🛣️ Roadmap

- [x] Version 1.0 - Initial Release
- [x] Version 1.1 - Features Expansion
- [ ] [Version 1.2 - In Development 🚧](https://github.com/mattyhakin/glucose_tracker/milestone/1)

Visit the [Milestones page](https://github.com/mattyhakin/glucose_tracker/milestones) to see progress on upcoming features!

 🤝 Contributing

We welcome contributions of all kinds — bug fixes, feature suggestions, ideas!  
Feel free to open an Issue or a Pull Request anytime.

If you have suggestions for improvements, ideas for new features, or find any bugs, please feel free to:

- Fork the repository
- Create a new branch (`git checkout -b feature-YourFeatureName`)
- Make your changes
- Commit your changes (`git commit -m 'Add some feature'`)
- Push to the branch (`git push origin feature-YourFeatureName`)
- Open a Pull Request


Thanks for helping make this app better! 🎯

## 🌟 Future Ideas

- Add Dark Mode toggle for better nighttime use
- Integrate Google Sheets or OneDrive backup option
- Add email reminders for recording new readings
- Enable tracking of insulin dosages and timings
- Weekly and monthly report generation (PDF download)
- Mobile-friendly view improvements
- Set personal glucose targets and alerts
- Add basic analytics (average glucose over time, variability trends)

---

*Have more ideas? Feel free to suggest by opening an Issue!*

## 🛠 Development Progress

We track all new features, improvements, and bug fixes on our Project Board:

➡️ [View the Glucose Tracker Development Board](https://github.com/mattyhakin/glucose_tracker/projects/1)

You can see:

- What features are planned
- What's currently in progress
- What's already completed

Stay updated and feel free to contribute!

---

## 📨 Need Help or Have Ideas?

- Report a [Bug](https://github.com/mattyhakin/glucose_tracker/issues/new?template=bug_report.md)
- Suggest a [Feature](https://github.com/mattyhakin/glucose_tracker/issues/new?template=feature_request.md)
- Ask a [Question](https://github.com/mattyhakin/glucose_tracker/issues/new?template=contact_us.md)

## 🙏 Acknowledgements

This project was made possible thanks to:

- [Streamlit](https://streamlit.io/) - for making web app development simple and powerful
- [Pandas](https://pandas.pydata.org/) - for data handling and manipulation
- [Matplotlib](https://matplotlib.org/) - for beautiful graphs and plots
- [GitHub](https://github.com/) - for hosting, version control, and collaboration tools
- [Contributor Covenant](https://www.contributor-covenant.org/) - for the Code of Conduct template
- [Shields.io](https://shields.io/) - for badges

Special thanks to the open-source community for inspiration and guidance.

---