BharatWallet (Android-first, iOS-ready)

Production-grade scaffold for a universal wallet app for India. MVP includes wallet storage, encrypted local data, Firebase metadata, OAuth email import, NFC prep, biometrics, location, and push notifications.

Tech Stack

• Flutter + Riverpod
• Firebase Auth + Firestore (metadata only)
• flutter_secure_storage (encrypted local storage)
• local_auth (biometrics)
• flutter_nfc_kit, geolocator, firebase_messaging
• flutter_appauth, google_sign_in (OAuth)

Project Structure

• lib/screens – Onboarding, Home, Wallet, AddItem, Reminders, Settings
• lib/components – reusable UI like SecureInput
• lib/services – Firebase, OAuth, metadata
• lib/utils – encryption, QR parser
• assets/ – put Figma assets here
• config/ – create firebase_config.dart, OAuth keys (not committed)

Getting Started

1. Install deps

flutter pub get

2. Firebase setup (manual)

• Create Firebase project
• Enable Auth (Email + Phone)
• Create Firestore (native mode)
• Add Android app (use your applicationId), download google-services.json into android/app/
• Add iOS app later, place GoogleService-Info.plist into ios/Runner/
• Create lib/config/firebase_config.dart exporting placeholders if needed

3. Android configuration

• In android/app/build.gradle set applicationId as desired
• Add permissions in AndroidManifest.xml as needed: INTERNET, NFC, ACCESS_FINE_LOCATION, RECEIVE

4. OAuth (manual)

• Google Cloud Console: enable Gmail API, create OAuth client
• Get client_id, client_secret, redirect_uri
• Store securely (e.g., lib/config/oauth.dart, not committed)

5. Figma Assets (manual)

• Export icons/images
• Place in assets/images/, assets/icons/, assets/fonts/
• Update pubspec.yaml assets

6. Run on Pixel 7 Pro

flutter devices
flutter run -d <device_id>

Notes

• Sensitive data never leaves the device; only metadata in Firestore.
• Biometric prompts are used to access encrypted items.

bharat_wallet

A new Flutter project.

Getting Started

This project is a starting point for a Flutter application.

A few resources to get you started if this is your first Flutter project:

• Lab: Write your first Flutter app
• Cookbook: Useful Flutter samples

For help getting started with Flutter development, view the online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.