Gluko is a web application designed to help individuals and families more accurately calculate the carbohydrate content in their meals. By providing an easy-to-use interface and leveraging the Canadian Nutrient File database, Gluko simplifies carb counting and ensures precision in determining the carb factor of various nutrients.
- 🧮 Meal Calculator: Calculate total carbohydrates in your meals by combining different ingredients
- 🔍 Carb Factor Search: Quick access to carbohydrate content of common foods
- 📊 Nutrient Information: Detailed nutritional information from the Canadian Nutrient File
- 🌐 Bilingual Support: Available in English and French
- 🌙 Dark Mode: Comfortable viewing in any lighting condition
- 📱 Responsive Design: Works on desktop and mobile devices
- 🗂️ Meal History: Save, view, and filter past meals for easy tracking and review
- 👨👧👦 Multi-Subject Support: Manage meal history for multiple subjects (e.g., parents with multiple children living with Type 1 Diabetes)
- 🔎 Advanced Filtering: Filter meal history by date range, subject, and tags
Managing Type 1 Diabetes requires constant attention to carbohydrate intake to determine proper insulin dosing. Gluko aims to make this process easier by:
- Providing quick access to reliable nutritional information
- Enabling easy calculation of complex meals
- Offering a user-friendly interface for daily use
- Using official Canadian nutritional data
- Supporting families and caregivers with multi-subject management and meal tracking
Gluko is NOT a certified medical device or application. This project is a carbohydrate counting reference and calculation tool only.
Do NOT use Gluko as a substitute for professional medical advice. Always:
- Consult with your healthcare provider before making any diabetes management decisions
- Verify nutritional information against reliable sources
- Exercise careful review of all calculations
- Understand that nutritional data may contain errors or be incomplete
- Use this app only as a supplementary guide tool
This application is not approved by health authorities and should not be relied upon for medical purposes. Proper insulin dosing and diabetes management require professional medical guidance.
This project is experimental and not intended for medical use. Always consult with a healthcare professional for medical advice and insulin dosing.
Visit https://gcharest.github.io/gluko/ to start using Gluko right away.
If you want to contribute to the project or run it locally:
-
Prerequisites
- Node.js (v22 recommended)
- npm
-
Installation
npm install
-
Development Server
npm run dev
Open your browser and navigate to
http://localhost:5173to see the applicationRecommended (cross-platform, uses bundled helper):
npm run dev:local
This runs a small Node helper that computes the git short SHA and ISO build date, sets
VERSIONandBUILD_DATEfor the Vite process, and starts the dev server. Use this on Windows, macOS and Linux.Manual one-liners (if you prefer to set envs yourself):
Windows cmd.exe:
set VERSION=abcd123 && set BUILD_DATE=2025-10-23T12:00:00Z && npx vite
PowerShell:
$env:VERSION = 'abcd123'; $env:BUILD_DATE = '2025-10-23T12:00:00Z'; npx vite
Notes:
- The helper script (
npm run dev:local) prefers the locally installedvitebinary and will fail with a message instructing you to runnpm ciif devDependencies are missing. - Setting environment variables inline differs between shells; prefer the helper for simplicity.
- The helper script (
-
Building for Production
npm run build
The production-ready files will be in the dist directory
-
Running Tests
-
Unit Tests:
npm run test:unit
-
End-to-End Tests:
npx playwright install npm run test:e2e
-
Contributions are welcome! Whether it's:
- Reporting bugs
- Suggesting enhancements
- Improving documentation
- Submitting pull requests
This project is licensed under the MIT License - see the LICENSE file for details.