EvolioHealth specifications
EvolioHealth is a private, self-hosted platform for recording, synchronizing, and visualizing personal health, activity, body-measurement, and progress-photo data.
The product has two deliverables:
- EvolioHealth Server: Go business API, bundled Flutter Web application, internal PocketBase persistence, encrypted private media, and a replaceable SQLite reference database.
- EvolioHealth Companion: Android Flutter application with offline storage, Health Connect integration, and direct Bluetooth Low Energy support for the Xiaomi Mi Body Composition Scale 2.
This package is the initial product and architecture source of truth for implementation by Codex. Start with the documentation index.
Fixed principles
- Privacy and strict user isolation are product requirements.
- PocketBase is never directly exposed.
- Deployment uses one
compose.yaml;APP_ENV=dev|prodselects runtime behavior. - Runtime containers are non-root, capability-free, and compatible with common Linux NAS/container hosts.
- Data ownership, export, correction, and deletion are first-class features.
- The initial mobile target is Android only.
Status
This specification defines the intended first production architecture and staged delivery plan. Future exercise and nutrition catalogs are anticipated, but their complete user workflows are not required for the first usable release.