Privacy-first personal health journal with experimental AI features. Track medications, journal symptoms, and explore on-device ML (for educational purposes)
TensorFlow Lite Flutter plugin provides an easy, flexible, and fast Dart API to integrate TFLite models in flutter apps across mobile and desktop platforms.
v2.0.0A Flutter plugin for creating customizable animated text widgets, enhancing app aesthetics with engaging text animations.
v1.17.6Cristalyse is a high-performance data visualization library for Dart/Flutter that implements grammar of graphics principles with native rendering capabilities.
v1.2.0An open-source state of the art UI library for Flutter
v1.1.74,700+ Free Flutter Icons with automatic theme color inheritance and dark mode support. Created by Hugeicons Pro Icon Library. The most beautiful icon library for developers.
{"sdk":"flutter"}^2.3.0^16.3.0^2.6.1^0.20.2^4.2.4^2.0.0^2.2.3^1.1.0^2.1.5^1.17.6^0.12.1^3.12.0^11.0.0^19.5.0^12.0.3^0.10.5^6.2.5^1.6.0^0.15.4^0.10.1^1.1.7^0.25.0^8.0.0{"sdk":"flutter"}{"sdk":"flutter"}^0.14.3^6.0.0^5.6.4^2.15.0English project snapshot. Visit GitHub for the latest content.
Flutter Dart License Build Status Version
A privacy-first mental health companion that helps you track your wellness journey, manage medications, and find emotional support.
Your data stays on your device. Always.
PinkRain is a comprehensive mental health and wellness tracking application designed with privacy at its core. Unlike other health apps, all your data remains securely stored on your device and never leaves your phone. The app provides mood tracking, medication management, wellness analytics, breathing exercises, and guided meditation to support your mental wellness journey.
🧪 Experimental AI Feature: PinkRain also includes an optional experimental AI-powered symptom prediction feature that can be enabled during development or testing. This feature is disabled by default in the main app build, ensuring the standard version focuses on core wellness tracking without AI dependencies.
❗ IMPORTANT DISCLAIMER: This is an experimental research project made open source for educational and development purposes. This app is NOT a medical device and does not claim to improve your mental or physical health in any way. It should NEVER be considered a replacement for professional healthcare providers, licensed therapists, psychiatrists, or medical professionals. Consult qualified healthcare providers for medical advice, diagnosis, or treatment.
Clone the repository
git clone https://github.com/rudi-q/pinkrain_health_journal.git
cd pinkrain_health_journal
Install dependencies
flutter pub get
Run the app
flutter run
PinkRain includes an experimental AI-powered symptom prediction feature using TensorFlow Lite. This feature is NOT enabled by default in the main app. The standard PinkRain app works fully without any AI functionality, focusing on core wellness tracking features.
The standard PinkRain app includes all core features without AI:
Run standard app:
# Development
flutter run
# Release builds (no AI)
flutter build apk --release
flutter build appbundle --release
flutter build ios --release
If you want to try the experimental AI symptom prediction feature, you can build PinkRain with AI enabled:
Enable Experimental AI Symptom Prediction:
# Development
flutter run --dart-define=EXPERIMENTAL=true
# Release builds with AI
flutter build apk --release --dart-define=EXPERIMENTAL=true
flutter build appbundle --release --dart-define=EXPERIMENTAL=true
flutter build ios --release --dart-define=EXPERIMENTAL=true
Important Notes:
- The experimental AI feature adds ~12MB to the app size (TensorFlow Lite models)
- When experimental mode is disabled (default), the app functions normally without any AI features
- The TensorFlow Lite model files may still be included in the bundle but are not loaded into memory when AI is disabled
- Web Platform: Experimental AI features are automatically disabled on web platforms regardless of the
EXPERIMENTALflag, as TensorFlow Lite is not supported in web browsers- The AI feature is experimental and should not be relied upon for medical decisions
PinkRain follows clean architecture principles with clear separation of concerns:
lib/
├── core/
│ ├── models/ # Data models
│ ├── services/ # Core services (Hive, Navigation)
│ ├── theme/ # App theming
│ ├── util/ # Utilities and helpers
│ └── widgets/ # Reusable widgets
├── features/
│ ├── journal/ # Mood tracking and journaling
│ ├── pillbox/ # Medication management
│ ├── wellness/ # Analytics and insights
│ ├── breathing/ # Breathing exercises
│ ├── meditation/ # Guided meditation
│ └── profile/ # User settings
└── main.dart
PinkRain includes comprehensive testing:
# Run all tests
flutter test
# Run integration tests
flutter drive --target=integration_test/app_test.dart
# Run specific test files
flutter test test/features/journal/
We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.
git checkout -b feature/amazing-feature
flutter test
git commit -m "Add amazing feature"
git push origin feature/amazing-feature
This application is an experimental research project developed for educational, research, and open-source development purposes. It is made available to the community to advance understanding of mental health tracking technologies and privacy-preserving app development.
IMPORTANT: This app is NOT:
ALWAYS consult with qualified healthcare professionals including but not limited to:
Before making any decisions about your mental health, medication, or treatment based on information from this app.
If you are experiencing a mental health emergency or crisis:
By using this experimental research application, you acknowledge that:
This is a research project designed to:
This project is licensed under the MIT License - see the LICENSE file for details.
Additional Terms: By using this software, you acknowledge that you have read and understood the Medical Disclaimer above and agree to use this experimental research application in accordance with these terms.
Need help or have questions?
Made with 🩷 for mental health awareness
⭐ Star this repo if you found it helpful! ⭐