Consistency is easier to understand when you can see it.
NutriFlow brings everyday records and longer-term changes into one quiet workspace. It is a personal tracking tool—not a calorie prescription, a diet plan, or a substitute for medical advice.
📸 A Look Inside
An iOS-inspired interface: grouped entry form, at-a-glance daily cards, and a trend chart with your 7-day average and personal target (shown above).
On phones, a frosted bottom tab bar jumps between sections, and the dark mode follows the iOS graphite palette.
📊 The Daily Picture
Record what matters to you, then return to see how the days fit together.
✨ More Than a Daily Number
- 📅 Calendar & streaks — Review when you recorded information and keep your history easy to navigate.
- 📈 Trends at different scales — Switch between 7-day, 30-day, and full-history views.
- 🌗 Light & dark — Choose the visual theme that suits your workspace.
- 📱 Made for phones too — A bottom tab bar, large touch targets, and charts that stay readable on narrow screens.
- 📥 Flexible imports — Bring in existing records from supported text, CSV, or JSON formats, with a preview before applying changes.
- 🛡️ Reliable feedback — Failed saves are surfaced instead of presenting an unsaved change as successful.
💻 One Tracker. Two Ways to Open It.
No application server, account, or package installation is required for everyday use. The interface is in Simplified Chinese; this guide is in English.
[!IMPORTANT]
Use the correct entry. NutriFlow.html is the clean, official standalone application. The repository's index.html contains development/demo seed data and extra PWA wiring; it is not the official offline distribution file. GitHub Pages publishes the clean NutriFlow.html content, not the seeded development entry.
🔒 Your Data Stays Yours
NutriFlow stores your records and preferences in the current browser's localStorage. Ordinary tracking does not upload your entries to a server or synchronize them with an account.
📦 Three Ways to Export
| Format | Best for | Includes |
|---|
| CSV | Spreadsheets and simple record review | Daily measurements |
| JSON | Record-only interchange and older data formats | Daily record array |
| Full backup | Moving or restoring your complete tracker state | Records, personal targets, and theme |
Moving between the website and an offline HTML file? They do not automatically share data. Export a full backup from the original location, then import it in the destination.
[!WARNING]
Local storage is not a cloud backup. Clearing site data, switching browsers, changing devices, or using a different file origin can make existing records inaccessible. Export a full backup before making those changes. Browser behavior for file:// storage may vary.
🛡️ Imports With a Safety Check
- An import is previewed before confirmation; matching existing dates can be deliberately overwritten.
- Duplicate dates within the same import batch are rejected as a batch, rather than silently choosing one record.
- Empty fields and numeric zero are treated differently when parsing structured columns.
- Full-backup restoration has rollback and recovery-journal safeguards. If recovery remains unresolved, persistent writes are paused rather than risking further damage.
These safeguards protect data integrity, but they do not replace keeping a separate exported backup.
CSV or tab-separated rows use this fixed order: date, intake (kcal), weight (kg), protein (g), water (ml). Keep an empty column when a measurement is missing; do not shift later values left. These sample rows omit a header:
2026-01-01,1800,70.0,100,2000
2026-01-02,1750,,105,2100
Labeled plain text can omit optional measurements and use a different order:
2026-01-02 protein 105g intake 1750kcal water 2100ml
Choose one example for the preview, check the field values, then confirm the import. These are sample records, not recommended personal targets.
⚙️ For Developers
NutriFlow is built with plain HTML, CSS, and JavaScript. Each app entry contains its own markup, styles, and scripts; there is no npm package, framework build, or runtime dependency.
Source map
Verify changes
From the repository root, with Node.js available:
node test-reliability.js
node test-parity.js
node check-html-syntax.js
node check-repo-structure.js
For UI or storage changes, the repository also includes tests/browser-regressions.py, which exercises browser workflows through Python Playwright with Chromium. These testing tools are not dependencies of the application itself.
The Pages workflow validates the repository and publishes a clean copy of NutriFlow.html. When editing application behavior, keep both HTML versions aligned except for the intentional seed/PWA differences. Preserve existing storage keys, data compatibility, and transactional save/restore behavior; see AGENTS.md.
📜 License & Scope
No repository-wide open-source license is currently declared. Public visibility does not by itself grant unrestricted permission to copy, modify, or redistribute the project.
NutriFlow is a personal record-keeping tool, not a medical or nutritional recommendation service. Its value is in making your own entries and trends easier to understand.
Website analytics
The public website uses Cloudflare Web Analytics for aggregate page visits and performance. The beacon loads only on seiya058904.github.io; local previews and offline copies do not load it. No game saves, journal entries, map contents, or form values are passed to the analytics integration. Statistics start after deployment and do not recover earlier traffic. See Cloudflare's privacy policy.
