Skip to content
timmylichPublic

About

Private, offline-first health tracker for Android: food & 12 nutrients, water, steps, blood pressure, weight, pantry. No ads, no accounts, no Google services.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Wellness logo

Wellness

An open-source, offline-first health tracker for Android.
Food · Water · Steps & workouts · Blood pressure · Body composition · Pantry · Health tips

Latest release CI License: AGPL v3 Android 8+ Downloads

No ads · No accounts · No analytics · No Google services · Your data stays on your phone

⬇ Download APK · ❤ Support · 🇷🇺 По-русски


Daily summary Adding food Blood pressure and pulse Health tips

Pantry with expiry dates Adding a pantry product Settings and more

Features

  • Fast and native — written in Kotlin with Jetpack Compose: starts in under half a second, smooth swipes and charts, a 1.8 MB APK, no JavaScript engine and no Google Play services.
  • Food — 12 daily scales (calories, protein, fat, carbs, sugar, added sugar, sodium, fibre, saturated and trans fat, cholesterol, potassium) with personal minimum, target and maximum, computed from your profile, goal pace and today's activity. Limit-only nutrients show a limit.
  • Fast food logging without AI — recent foods, favourites, a bundled offline database (CIS dishes plus ~2300 European foods from ANSES-CIQUAL), Open Food Facts and USDA search, barcodes, counting by pieces, custom foods based on an existing product, editable log entries and importable food packs.
  • Energy balance — intake vs expenditure (BMR × lifestyle + workouts + steps), surplus or deficit converted into estimated fat mass; optional adaptive targets.
  • Water — one big button for water and a separate one for other drinks, charts up to a year, recommended range and a clearly marked dangerous amount (hyponatremia).
  • Activity — background step counting from the phone's hardware sensor (no Google Fit needed) or Health Connect, MET-based workout templates, custom workouts.
  • Heart — blood pressure and pulse log with ACC/AHA classification and heart-rate zones.
  • Body — weight trend (time-weighted average), body fat (measured, US Navy or BMI-based estimate), BMI, waist-to-height ratio, healthy weight range.
  • Pantry (optional) — what you have at home, purchase and expiry dates, a freshness bar, how much is left, nutrition tags and a reminder the day before a product expires.
  • Tips — fresh air, drinking water, cancer prevention, sun, back health, sleep, nutrition.
  • Yours to configure — English and Russian, sections on/off, theme and accent colour, animations, goal pace slider, custom nutrient limits, JSON export/import.

Every formula and limit cites its source (WHO, IOM/EFSA, ACC/AHA, USDA…) in Calc.kt and is covered by unit tests.

Install

Download the APK from Releases and open it on your phone (allow installing from your browser or file manager when asked). The app can notify you about new versions (Settings → Notifications). An F-Droid listing is planned.

Privacy

All data is stored only on the device. Optional network requests:

Request What is sent Can be turned off
Food search (Open Food Facts, USDA) the search text or barcode Settings → Food
Update check (GitHub Releases) nothing but a request to api.github.com Settings → Notifications

Health Connect access is optional and read-only (steps). There are no analytics, crash reporters, ads or Google Play services in the app.

Tech

  • Native Android: Kotlin, Jetpack Compose (foundation + Material 3 bottom sheets), one activity
  • Hand-drawn Canvas charts, a small immutable store saved as one JSON file
  • A foreground service for the hardware step counter, local notifications via AlarmManager
  • UI strings in app/src/main/assets/i18n_{ru,en}.json, Lucide icons as vector drawables
  • No Google Play services; the only libraries are AndroidX, kotlinx.serialization and Health Connect's client

The 1.8 MB APK starts about 3× faster than the former React Native version (0.5.x). See docs/architecture.md for a tour of the code.

Build from source

Requirements: JDK 17–21, Android SDK (platform 36).

./gradlew testDebugUnitTest       # unit tests (also run in CI)
./gradlew installDebug            # debug build on a connected device
./gradlew assembleRelease         # → app/build/outputs/apk/release/ (unsigned)

Sign a local release with scripts/install-signed.ps1, or put storeFile, storePassword, keyAlias and keyPassword into a git-ignored keystore.properties. Releases are built by GitHub Actions — see docs/releasing.md.

Support the project

Wellness is free and built in spare time. If it helps you:

Crypto addresses
Network Address
Ethereum and EVM networks (BNB Chain, Base, Arbitrum, Optimism, Polygon) 0xe790989b801ddbc706f391b10bec0e6c1a1fd334
Solana HJq4ocLn8eua95WKQs82N4hZ2S7VABANefTrSoUqo6rb
TRON TMKejJ5a5unasnZiVZ1Vz8GvkXsDj7mvPE
TON (Gram, W5 wallet) UQCOymZAvj5ho73JlD1s1-qo-pD-bqIQ-H_Y4FEjX7Sp68rI

Double-check the network before sending.

Contributing

Code, translations, food data and health tips are welcome — see CONTRIBUTING.md.

Medical disclaimer

Wellness is not a medical device. Recommendations are general guidelines for healthy adults and do not replace a doctor's advice.

License

Wellness is free software: you can redistribute and modify it under the terms of the GNU Affero General Public License v3. Modified versions you distribute (or run as a network service) must be released under the same license with their source code.

Food data: Open Food Facts — ODbL; ANSES-CIQUAL 2020 — Etalab Open Licence 2.0. Icons: Lucide (ISC).


По-русски

Wellness — бесплатный трекер здоровья с открытым кодом. Без рекламы, регистрации, слежки и сервисов Google: все данные хранятся только на телефоне.

  • Быстрое и нативное: Kotlin и Jetpack Compose, запуск меньше чем за полсекунды, плавные свайпы и графики, APK 1,8 МБ, без JavaScript-движка и сервисов Google.
  • Еда: 12 шкал с личными диапазонами (минимум — цель — максимум), офлайн-база продуктов, поиск в Open Food Facts и USDA, штрихкоды, счёт по штукам, свои продукты на основе готовых, редактирование записей, энергобаланс, советы.
  • Вода: большая кнопка для воды и отдельная для напитков, графики, норма и опасный объём.
  • Активность: фоновый подсчёт шагов датчиком телефона (без Google Fit) или Health Connect, шаблоны тренировок.
  • Сердце: давление и пульс, классификация, пульсовые зоны.
  • Тело: вес со взвешенным средним, % жира, талия, ИМТ, подходящий вес.
  • Продукты (по желанию): что есть дома, сроки годности, полоса свежести, сколько осталось, метки состава и напоминание за день до окончания срока.
  • Советы: воздух, вода, профилактика рака, солнце, спина, сон.

Установка: скачайте APK со страницы Releases.

Поддержать автора: ⭐ звезда на GitHub · 💳 Tribute — карты, крипта, СБП (в Telegram, в браузере) · 📣 Telegram-канал. Адреса криптокошельков — в разделе Support the project.

Лицензия — GNU AGPL v3: код можно использовать и изменять, но любые распространяемые изменённые версии обязаны оставаться открытыми под той же лицензией.

About

Private, offline-first health tracker for Android: food & 12 nutrients, water, steps, blood pressure, weight, pantry. No ads, no accounts, no Google services.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Sponsor this project

Contributors

Languages