wellium

wellium puts you squarely in charge of your own health story by keeping your medical records on devices you control and sharing them securely with clinicians. Many cloud-based health platforms can raise concerns around privacy, and may even affect insurance or treatment without your knowledge. By combining user-first ownership with seamless provider collaboration, wellium gives you a single source of truth for all your health information.

Built on Ionic (a cross-platform web framework) and Capacitor (a native-bridge layer), wellium runs natively on Android, iOS, the web, and desktop. Records live locally in a lightweight SQLite database and are encrypted at rest under AES-256. When you share or sync data, we employ a hybrid post-quantum scheme, using Kyber (via our ML-KEM wrapper) to negotiate session keys, and then AES-256 to encrypt the bulk data, so your information stays confidential even against future quantum attacks. You can import CSV files or FHIR XML exports (Fast Healthcare Interoperability Resources) from sources like Apple Health, and export in the same standard formats for backup or sharing. All telemetry and error logs go to a local JSON file or (optionally) to Sentry, so you can troubleshoot without leaking personal details.

---

Quick Start

1. Install prerequisites: Node.js (version ≥16) and npm; Ionic CLI (run npm install -g @ionic/cli).

2. Clone the repository:

   git clone https://github.com/by-The-Lindemans/wellium.git
   cd wellium

3. Install dependencies:

   npm install

4. Run in browser for development:

   ionic serve

5. Build and run on device (Android example):

   ionic build
   npx cap add android
   npx cap open android

---

Community & Support

Need help or want to share ideas? Open an issue on GitHub or join our discussion board:

• Issue tracker
• Discussion board

---

Contributing

We welcome work that strengthens patient ownership and provider collaboration. When you submit a pull request:

• Read CONTRIBUTING.md and follow the CODE_OF_CONDUCT.md.
• Run npm test and keep all tests passing.
• Explain how your change helps users keep an accurate health record in one place and work more smoothly with their care providers.

Your contributions help build a health platform that respects patient data and empowers care teams.

---

© 2025 by The Lindemans; licensed under MPL‑2.0 (Mozilla Public License 2.0). Governance documents use CC0‑1.0.