F-Card (Loyalty & Membership Wallet)

A premium, minimalist loyalty card wallet application inspired by the Apple Wallet design system, built with Flutter. F-Card allows you to digitize, organize, and manage your physical loyalty, store, and membership cards in one beautiful, secure place.

Features

• Apple Wallet-Style Card Stack: A gorgeously animated vertical stack of card headers that fans out upon scrolling. Favorite cards are pinned to the top.
• Interactive 3D Flip Card: Tap a card to expand it (via a seamless Hero transition), and click the information icon to flip the card in 3D to access its details, notes, and management actions (Edit, Archive, Delete).
• Automated Color Extraction: Dynamically extracts the dominant brand color from your store logo using palette_generator to style the card header automatically.
• Versatile Barcode Scanner: Scan physical barcodes in real time using the device camera or select a screenshot/image from your gallery to auto-detect barcodes. Supports 13 major barcode formats (QR Code, EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93, Codabar, ITF, Data Matrix, Aztec, PDF 417).
• Seamless Migrations: Import your backups directly from competing apps like Stocard, Fidme, VoucherVault, and Catima.
• Secure Backup & Restore: Export/Import your cards database and images as a password-protected, encrypted ZIP file, or JSON/CSV files.
• Android Platform Features:
  • App Shortcuts: Quick launcher shortcuts for your most used cards.
  • System Device Controls: Access cards from the Power Menu / Quick Settings panel (Android 11+).
  • Content Provider: Secure read-only integration for third-party extensions or widgets.
• Rich Preferences: Support for Light Mode, Dark Mode, OLED True Black, screen brightness maximization for scanners, wake-lock (keep screen on), and system language overrides.

Tech Stack

• Framework: Flutter
• State Management & DI: Provider
• Local Database: SQLite (sqflite) with FTS4 Full-Text Search and auto-updating search triggers
• Key Dependencies:
  • mobile_scanner & barcode_widget for scanning & rendering
  • flip_card for the 3D flipping effect
  • palette_generator for dynamic color extraction
  • image_cropper & image_picker for card photo customization
  • wakelock_plus & screen_brightness for barcode scanner readability
  • quick_actions for home screen shortcuts
  • archive & crypto for encrypted backups

Architecture

F-Card uses a clean, layered architecture:

• lib/domain: Business entities and core models (Card, Group) and import/export use cases (importers).
• lib/data: Services (SQLite database initialization, FTS triggers, ZIP packaging, parser logic) and repositories.
• lib/ui: Apple Wallet aesthetic implementation.
  • core/: Custom theme, app colors, and card helper utilities.
  • features/: Divided by module (Dashboard, Card Detail, Card Edit, Scanner, Settings).

Getting Started

1. Install Flutter SDK.
2. Clone the repository.
3. Fetch dependencies:

   flutter pub get

4. Run the app:

   flutter run

---

F-Card (Sadakat & Üyelik Kartı Cüzdanı)

Apple Wallet tasarım sisteminden ilham alan, Flutter ile geliştirilmiş, minimalist ve üst düzey premium bir sadakat kartı cüzdanı uygulamasıdır. F-Card; fiziksel sadakat, mağaza ve üyelik kartlarınızı dijitalleştirip şık ve güvenli tek bir yerde organize etmenize olanak tanır.

Özellikler

• Apple Wallet Tarzı Kart Yığını: Aşağı kaydırıldığında yelpaze gibi açılan (fan-out) şık animasyonlu dikey kart yığını. Favori kartlar her zaman en üstte sabitlenir.
• Etkileşimli 3D Kart Döndürme: Karta dokunulduğunda akıcı bir Hero geçişi ile genişler. Bilgi ("i") ikonuna dokunduğunuzda kart 3D eksende dönerek notlar, geçerlilik tarihleri, kart numarası gibi detaylara ve kart yönetim butonlarına (Düzenle, Arşivle, Sil) erişim sağlar.
• Dinamik Renk Algılama: Yüklenen logodan baskın marka rengini otomatik olarak çıkarır (palette_generator) ve kart başlık rengini buna göre ayarlar.
• Gelişmiş Barkod Okuyucu: Kamera yardımıyla fiziksel barkodları gerçek zamanlı tarayın veya galerinizden seçtiğiniz bir ekran görüntüsünü/görseli otomatik analiz ederek barkodu çözün. 13 farklı barkod formatını (QR Code, EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93, Codabar, ITF, Data Matrix, Aztec, PDF 417) destekler.
• Kolay Geçiş Desteği: Rakip uygulamalardan (Stocard, Fidme, VoucherVault, Catima) yedek dosyalarınızı doğrudan F-Card'a aktarın.
• Güvenli Yedekleme ve Kurtarma: Tüm kartlarınızı ve görsellerinizi şifreli bir ZIP dosyası veya JSON/CSV formatlarında dışa/içe aktarın.
• Android Platform Entegrasyonları:
  • Uygulama Kısayolları (App Shortcuts): En sık kullandığınız kartlara ana ekrandan hızlıca erişin.
  • Hızlı Cihaz Denetimleri (Power Menu): Android 11+ güç menüsünde veya hızlı ayarlar panelinde kartlarınızı listeleyin ve kilidi açmadan erişin.
  • İçerik Sağlayıcı (Content Provider): Diğer uygulamaların veya widget'ların kart verilerine salt okunur erişimini sağlayan güvenli API.
• Zengin Özelleştirmeler: Açık Tema, Koyu Tema, OLED Siyah desteği, parlaklık maksimizasyonu, ekranı açık tutma (Wakelock) ve sistem dilinden bağımsız uygulama içi dil seçimi.

Teknoloji Yığını

• Arayüz Framework: Flutter
• Durum Yönetimi & DI: Provider
• Yerel Veritabanı: SQLite (sqflite), FTS4 Tam Metin Arama desteği ve otomatik güncellenen tetikleyiciler (triggers).
• Önemli Kütüphaneler:
  • Tarama ve barkod çizimi için mobile_scanner ve barcode_widget
  • 3D kart döndürme efekti için flip_card
  • Dinamik renk tespiti için palette_generator
  • Kart görseli kırpma ve seçme için image_cropper ve image_picker
  • Barkod tarayıcı okunabilirliği için wakelock_plus ve screen_brightness
  • Ana ekran kısayolları için quick_actions
  • Şifreli yedekler için archive ve crypto

Mimari Yapı

F-Card, temiz ve katmanlı bir mimari kullanır:

• lib/domain: İş mantığı modelleri (Card, Group) ve dışarıdan içe aktarma kullanım senaryoları (importers).
• lib/data: SQLite veritabanı kurulumu, FTS tetikleyicileri, ZIP yedekleme paketleme işlemleri ve depolar (repositories).
• lib/ui: Apple Wallet tasarım dilinin hayata geçirildiği kullanıcı arayüzü.
  • core/: Uygulama teması, renkleri ve kart yardımcı araçları.
  • features/: Özelliğe göre ayrılmış modüller (Dashboard, Card Detail, Card Edit, Scanner, Settings).

Başlangıç

1. Flutter SDK'sını kurun.
2. Projeyi bilgisayarınıza klonlayın.
3. Bağımlılıkları yükleyin:

   flutter pub get

4. Uygulamayı çalıştırın:

   flutter run