Skip to content

anwer3712/diet-log

Repository files navigation

奶奶照護日誌 / Grandma Care Log

A free, open-source daily care tracking tool for elderly patients — built for family caregivers.

License: MIT Live Demo


What is this?

A bilingual (Traditional Chinese 🇹🇼 / Indonesian 🇮🇩) web app designed to help family caregivers track daily health data for elderly patients at home — especially those with chronic conditions requiring fluid management (heart failure, kidney disease, etc.).

No installation needed. Works on any smartphone browser. Data syncs to Google Sheets via Google Apps Script.


Features

  • Fluid intake tracking — water, medication drinks, nutritional supplements, meals (with daily target & progress bar)
  • Fluid output tracking — urine volume + color, bowel movements with status
  • Intelligent urine target algorithm — auto-calculates expected urine output based on water intake goal, adjusted for diuretic medication (×1.1–1.5 range) vs. no medication (×0.4–0.6 range); alerts caregiver if output is abnormal
  • Fluid overload warning — red alert when total intake exceeds 1,200 c.c.
  • Exercise logging — bottle lifts, foot presses, knee bends, standing assistance (with safety protocol checklist)
  • Blood pressure & heart rate — morning and evening measurements with measurement guidelines
  • Constipation alert system — auto-triggers warning every 2 hours between 60–72 hours after last bowel movement, with bilingual safety instructions prohibiting unsupervised enema use
  • Medication state tracking — diuretics and laxatives, persisted to cloud
  • Time-based reminder system — smart reminders for BP measurement, exercise slots, and bedtime urine check
  • Cloud sync — all data saved to Google Sheets via Google Apps Script; supports multi-caregiver households
  • Optimistic UI — records appear instantly without waiting for server response
  • Weekly cleaning reminders — built-in schedule for household hygiene tasks

Who is this for?

  • Family members caring for elderly parents or grandparents at home
  • Households with multiple rotating caregivers (especially across language barriers)
  • Patients with conditions requiring strict fluid monitoring (heart failure, dialysis, post-surgery recovery)

Tech Stack

Layer Technology
Frontend Vanilla HTML + JavaScript + Tailwind CSS
Backend Google Apps Script (serverless)
Database Google Sheets
Hosting GitHub Pages (free)

No frameworks. No build tools. No dependencies to install. Opens directly in any browser.


Setup / Self-Hosting

  1. Fork this repository
  2. Deploy your own Google Apps Script backend (see GAS_URL in index.html)
  3. Create a Google Sheet for data storage
  4. Update GAS_URL and SPREADSHEET_URL constants in index.html
  5. Enable GitHub Pages on your fork → done

Screenshots

Daily Tracking Target Dashboard Reminder System
Fluid intake log with category selection Real-time progress toward daily goal Time-based care reminders

(Live demo: https://anwer3712.github.io/diet-log/)


Motivation

Built out of necessity. When a family member required 24/7 home care with strict fluid management, existing apps were either too complex, English-only, or required monthly subscriptions. This tool was built specifically for a household where caregivers speak Traditional Chinese and Indonesian — and needed something that works on a phone, offline-capable, and free forever.


Roadmap

Planned improvements (community input welcome):

  • AI-assisted health analysis — integrate Claude to detect abnormal trends across fluid intake, urine output, and blood pressure data, and translate raw numbers into plain-language guidance for caregivers
  • AI caregiver Q&A — let caregivers ask questions in their own language ("her urine was dark today, should I worry?") grounded in the patient's actual logged data
  • Additional language pairs — English, Vietnamese, Tagalog, Thai for multicultural caregiving households
  • Offline mode — service worker caching for unstable connections
  • Printable weekly reports — one-page summaries for doctor visits
  • Multi-patient support — for households or small care facilities tracking more than one person

Contributing

Pull requests welcome — see CONTRIBUTING.md for how to help (translations especially appreciated). This project follows a Code of Conduct.

If you care for an elderly family member and need a feature — open an issue.


License

MIT © 2026 anwer3712

About

Free bilingual (zh-TW/Indonesian) elderly home-care tracking app for family caregivers - fluid intake/output, BP, exercise, smart alerts. No install, works in any browser.

Topics

Resources

License

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors