A privacy-focused, offline-first product expiry tracker built with Flutter.
- 📦 Track expiry dates for 12 product categories
- 📅 Dual expiry input: direct date entry or auto-calculation from manufacturing date + duration
- 📸 Barcode scanning with Open Food Facts API lookup (graceful offline fallback)
- 🔤 Camera OCR using Google ML Kit to extract dates from product labels
- 🔔 Local notifications: 30 days, 7 days, and on expiry day
- 🔍 Search and filter by category, status, and sort order
- 🌙 Light and dark mode with Material Design 3
- 🔒 100% offline — no account, no cloud, no tracking
- Flutter SDK 3.x+
- Android Studio or VS Code with Flutter plugin
- Android SDK (for Android builds)
# 1. Clone or extract the project
cd DatePing
# 2. Install dependencies
flutter pub get
# 3. Run on connected device or emulator
flutter run
# 4. Build release APK
flutter build apk --release- Minimum SDK: 21 (Android 5.0)
- Target SDK: 34
The following permissions are configured in AndroidManifest.xml:
CAMERA— barcode scanning and photo capturePOST_NOTIFICATIONS— local notifications (Android 13+)SCHEDULE_EXACT_ALARM— precise notification schedulingRECEIVE_BOOT_COMPLETED— reschedule notifications after rebootINTERNET— optional barcode product lookup (gracefully degrades offline)
flutter build apk --release
# Output: build/app/outputs/flutter-apk/app-release.apklib/
├── main.dart # Entry point
├── app.dart # MaterialApp + theming
├── core/
│ ├── constants/ # Colors, strings
│ ├── database/ # SQLite helper + DAO
│ ├── models/ # Product model
│ ├── notifications/ # Local notification service
│ └── utils/ # Date utils, expiry calculator
├── features/
│ ├── dashboard/ # Home screen + widgets
│ ├── add_product/ # Add/edit product (manual, barcode, OCR)
│ ├── product_detail/ # Product detail view
│ ├── search/ # Search & filter screen
│ └── settings/ # Notification & app settings
└── providers/ # ProductProvider, SettingsProvider
| Technology | Purpose |
|---|---|
| Flutter + Dart | Cross-platform framework |
| sqflite | Local SQLite database |
| provider | State management |
| flutter_local_notifications | Scheduled reminders |
| mobile_scanner | Barcode/QR scanning |
| google_mlkit_text_recognition | On-device OCR |
| image_picker | Camera + gallery access |
| flutter_animate | Micro-animations |
| google_fonts | Typography (Inter) |
| http | Barcode product lookup (optional) |