FlatWallet

Flat Wallet

A modern iOS app for managing loyalty cards and scannable codes. Keep all your store cards, membership codes, and QR passes in one place with quick access through widgets.

Features

• Scan & Store: Capture barcodes and QR codes using your camera
• Manual Entry: Add cards manually with support for EAN-8, EAN-13, Code 128, QR, Aztec, and PDF417
• Smart Organization: Grid/list view with search and usage tracking
• Lock Screen Widgets: Three widget types for quick access to your most-used cards
• Privacy-First: All data stored locally on your device using SwiftData
• Universal iOS: Native Swift app with dark mode support

Architecture

Built with Clean Architecture and modular Swift Package Manager structure. Strict one-way dependency flow ensures maintainability and testability.

Modules

• Domain: Business models (Card, Barcode), repository protocols, view models (CardsViewModel, ScannerViewModel)
• Data: SwiftData persistence layer (CardModel, LocalCardRepository, ModelContextProvider)
• Resources: Localization files (L10n.swift, Localizable.xcstrings)
• SharedUI: Shared UI components (CardCodeView, CardTile), DI container (Container.swift)
• AppUI: Main app screens, custom navigation stack, routing logic
• Widget Extension: Three widget types for lock screen/home screen access

Development

1. Open FlatWallet.xcworkspace in Xcode (or use SweetPad extension for VS Code)
2. Build scheme: App
3. Run on iOS 17+ device or simulator

Key Configuration

• Config: Config.xcconfig
• Package: FlatWallet/Package.swift

External Dependencies

• EAN - EAN-8/EAN-13 validation and rendering

Privacy

All card data is stored locally on your device using SwiftData. No data is transmitted to external servers. Camera access is only used for barcode scanning.

See: Privacy Policy (EN)

Polityka Prywatności (PL)

License

MIT License - see LICENSE

This site is open source. Improve this page.