Skip to content
abhishekmondal0509Public

About

Offline-first Flutter application for tracking product expiry dates with barcode scanning, OCR, local notifications, and smart reminder management.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

DatePing

A privacy-focused, offline-first product expiry tracker built with Flutter.

Features

  • 📦 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

Setup Instructions

Prerequisites

  • Flutter SDK 3.x+
  • Android Studio or VS Code with Flutter plugin
  • Android SDK (for Android builds)

Installation

# 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

Android Setup

  • Minimum SDK: 21 (Android 5.0)
  • Target SDK: 34

The following permissions are configured in AndroidManifest.xml:

  • CAMERA — barcode scanning and photo capture
  • POST_NOTIFICATIONS — local notifications (Android 13+)
  • SCHEDULE_EXACT_ALARM — precise notification scheduling
  • RECEIVE_BOOT_COMPLETED — reschedule notifications after reboot
  • INTERNET — optional barcode product lookup (gracefully degrades offline)

Building Release APK

flutter build apk --release
# Output: build/app/outputs/flutter-apk/app-release.apk

Project Structure

lib/
├── 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

Tech Stack

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)

About

Offline-first Flutter application for tracking product expiry dates with barcode scanning, OCR, local notifications, and smart reminder management.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages