SmartSip Hydration Flutter App

I have the SmartSip bottle-cap hardware fully covered—the ESP32-C3 inside streams JSON packets over Bluetooth Low Energy that contain flowRate (L/min), sipVolume (mL), and dailyTotal (mL). What I now need is the companion mobile experience built with Flutter so it runs smoothly on both Android and iOS.

Here is what matters most to me:

• Immediate BLE pairing and reconnection: the app should discover the cap, subscribe to its characteristic, and start parsing the incoming JSON with no manual UUID juggling for the user.

• Live visuals: a real-time read-out of current flow rate, the just-taken sip, and the running daily total. Updates arrive several times per second, so the UI must feel instantaneous.

• Insightful history: line or bar graphs that reveal trends by hour, day, week, and month, alongside a clean goal-ring (or similar) that fills as the user approaches the daily target they set.

• Gentle nudges: periodic push notifications reminding the user to drink, configurable in the settings screen.

All artwork should follow a modern, minimal aesthetic—light and dark themes included—while remaining battery-friendly. State management is up to you (Provider, Riverpod, Bloc, etc.) as long as the codebase stays readable and modular. I will expose any extra GATT characteristics you may need for settings, but the primary data channel is already in place.

Deliverables
1. Complete Flutter source code with clear build/run instructions
2. Production-ready Android (AAB) and iOS (IPA/TestFlight) builds
3. In-app onboarding for BLE pairing and daily goal setup
4. Graph and goal progress screens fed by locally persisted history (SQLite, Hive, or SharedPreferences—your call)
5. Notification scheduling tied to the user’s chosen interval
6. A brief technical doc describing architecture, BLE workflow, and how to extend the app if we later add a Wi-Fi/REST backend

I’ll provide sample JSON streams plus a development cap for testing. Once the milestones above check out on both platforms, the project is complete. Looking forward to seeing SmartSip come to life on mobile.