Flutter Wallet Card

A comprehensive Flutter plugin for creating and managing wallet cards on both iOS (Apple Wallet) and Android (Google Wallet). This plugin provides a unified API for generating, adding, and managing wallet passes across platforms.

Features

Cross-Platform Support

iOS: Full Apple Wallet (Passkit) integration
Android: Google Wallet integration
Unified API: Single codebase for both platforms

Card Operations

✅ Check wallet availability
✅ Add cards to wallet
✅ Check if card is already added
✅ View cards in wallet
✅ Generate card files from data
✅ Parse existing card files
✅ Download cards from URLs

Card Types Supported

Generic Cards: General purpose cards
Boarding Passes: Flight tickets
Coupons: Discount and promotional cards
Event Tickets: Concert, sports, and event passes
Store Cards: Loyalty and membership cards

Advanced Features

🎨 Custom colors and styling
📍 Location-based relevance
📅 Date-based relevance
🔒 Secure certificate signing (iOS)
🌐 Network download support
🧪 Comprehensive test coverage

Installation

Add this to your package's pubspec.yaml file:

dependencies:
  flutter_wallet_card: ^4.0.0

Then run:

flutter pub get

Platform Setup

iOS Setup

Enable Wallet capability in your iOS project:
- Open ios/Runner.xcworkspace in Xcode
- Select your target → Signing & Capabilities
- Add "Wallet" capability
Configure your Apple Developer account:
- Create a Pass Type ID in Apple Developer Console
- Generate certificates for pass signing

Android Setup

Add Google Wallet API to your project:
- Enable Google Wallet API in Google Cloud Console
- Configure OAuth 2.0 credentials

Update Android manifest (automatically handled by plugin):

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Usage

Basic Example

import 'package:flutter_wallet_card/flutter_wallet_card.dart';
import 'package:flutter_wallet_card/models/wallet_card.dart';

// Check if wallet is available
bool isAvailable = await FlutterWalletCard.isWalletAvailable();

if (isAvailable) {
  // Create a wallet card
  final card = WalletCard(
    id: 'my-card-123',
    type: WalletCardType.generic,
    platformData: {
      // iOS specific data
      'passTypeIdentifier': 'pass.com.yourcompany.yourpass',
      'teamIdentifier': 'YOUR_TEAM_ID',
      // Android specific data
      'issuerId': 'your-issuer-id',
      'classId': 'your-class-id',
    },
    metadata: WalletCardMetadata(
      title: 'My Awesome Card',
      description: 'This is a sample wallet card',
      organizationName: 'Your Company',
      serialNumber: 'CARD123',
    ),
    visuals: WalletCardVisuals(
      backgroundColor: '#1E88E5',
      foregroundColor: '#FFFFFF',
      labelColor: '#E3F2FD',
    ),
  );

  // Add card to wallet
  bool success = await FlutterWalletCard.addToWallet(card);
  
  if (success) {
    print('Card added successfully!');
  }
}

Advanced Usage

Creating Cards with Locations

final cardWithLocation = WalletCard(
  id: 'location-card',
  type: WalletCardType.storeCard,
  platformData: {
    'passTypeIdentifier': 'pass.com.yourcompany.store',
    'teamIdentifier': 'YOUR_TEAM_ID',
  },
  metadata: WalletCardMetadata(
    title: 'Store Loyalty Card',
    description: 'Get rewards at our store',
    organizationName: 'Your Store',
    locations: [
      WalletCardLocation(
        latitude: 37.7749,
        longitude: -122.4194,
        altitude: 100.0,
        relevantText: 'Welcome to our San Francisco store!',
      ),
    ],
  ),
  visuals: WalletCardVisuals(
    backgroundColor: '#4CAF50',
    foregroundColor: '#FFFFFF',
  ),
);

Generating Card Files

// Generate a card file for sharing or storage
File cardFile = await FlutterWalletCard.generateCardFile(
  card,
  outputDirectory: await getApplicationDocumentsDirectory(),
);

print('Card file created at: ${cardFile.path}');

Downloading Cards from URLs

// Download and add a card from a URL
try {
  File downloadedCard = await FlutterWalletCard.downloadFromUrl(
    'https://example.com/mycard.pkpass',
  );
  
  // Parse the downloaded card
  WalletCard card = await FlutterWalletCard.parseFromFile(downloadedCard.path);
  
  // Add to wallet
  await FlutterWalletCard.addToWallet(card);
} catch (e) {
  print('Failed to download card: $e');
}

Platform-Specific Features

// iOS: Add multiple cards at once
if (Platform.isIOS) {
  List<WalletCard> cards = [card1, card2, card3];
  bool success = await FlutterWalletCard.addMultipleToWallet(cards);
}

// Android: Save pass with JWT
if (Platform.isAndroid) {
  String jwt = 'your-google-wallet-jwt';
  bool success = await FlutterWalletCard.savePassWithJwt(jwt);
  
  // Create a pass link
  String link = await FlutterWalletCard.createPassLink({
    'objectId': 'your-object-id',
  });
}

API Reference

Core Methods

Method	Description	Returns
`isWalletAvailable()`	Check if wallet is available on device	`Future<bool>`
`isCardAdded(String cardId)`	Check if specific card is added	`Future<bool>`
`addToWallet(WalletCard card)`	Add card to wallet	`Future<bool>`
`viewInWallet(String cardId)`	Open card in wallet app	`Future<bool>`
`generateCardFile(WalletCard card)`	Generate card file	`Future<File>`
`parseFromFile(String path)`	Parse card from file	`Future<WalletCard>`
`downloadFromUrl(String url)`	Download card from URL	`Future<File>`

iOS-Specific Methods

Method	Description	Returns
`addMultipleToWallet(List<WalletCard> cards)`	Add multiple cards	`Future<bool>`

Android-Specific Methods

Method	Description	Returns
`savePassWithJwt(String jwt)`	Save pass using JWT	`Future<bool>`
`createPassLink(Map<String, dynamic> data)`	Create pass link	`Future<String>`

Models

WalletCard

The main model representing a wallet card:

class WalletCard {
  final String id;
  final WalletCardType type;
  final Map<String, dynamic> platformData;
  final WalletCardMetadata metadata;
  final WalletCardVisuals visuals;
  final File? file;
}

WalletCardMetadata

Card information and content:

class WalletCardMetadata {
  final String title;
  final String description;
  final String? organizationName;
  final String? serialNumber;
  final DateTime? expirationDate;
  final DateTime? relevantDate;
  final List<WalletCardLocation>? locations;
  final Map<String, dynamic>? additionalData;
}

WalletCardVisuals

Card appearance and styling:

class WalletCardVisuals {
  final String backgroundColor;
  final String foregroundColor;
  final String? labelColor;
  final Map<String, dynamic>? additionalStyles;
}

Error Handling

The plugin throws WalletException for wallet-related errors:

try {
  await FlutterWalletCard.addToWallet(card);
} on WalletException catch (e) {
  print('Wallet error: ${e.message}');
  if (e.details != null) {
    print('Details: ${e.details}');
  }
} catch (e) {
  print('General error: $e');
}

Testing

Run the test suite:

flutter test

For comprehensive testing:

flutter test test/test_all.dart

Migration from v3.x

If you're upgrading from version 3.x, here are the key changes:

Breaking Changes

New unified API: Replace platform-specific calls with unified methods
Updated models: Use new WalletCard model instead of separate iOS/Android models
Method names: Some method names have changed for consistency

Migration Example

Old (v3.x):

// iOS
await FlutterWalletCard.addPasskit(passData);

// Android
await FlutterWalletCard.addGoogleWallet(walletData);

New (v4.x):

// Unified
final card = WalletCard(/* ... */);
await FlutterWalletCard.addToWallet(card);

Development Resources

GitHub Actions Workflows - CI/CD and automation
Publishing Scripts - Package publishing tools

🚀 Development & Deployment

Local Development

# Validate package before publishing
./scripts/publish-package.sh validate

# Run comprehensive tests
./scripts/publish-package.sh test

Publishing

# Create a new release
./scripts/publish-package.sh release --version 1.0.0

# Publish to pub.dev (manual)
./scripts/publish-package.sh publish

Automated Workflows

This project includes comprehensive GitHub Actions workflows:

CI/CD Pipeline - Automated testing, validation, and quality checks
Package Publishing - Automated pub.dev releases
Release Management - Version bumping and changelog generation

See GitHub Actions Documentation for details.

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting PRs.

Development Setup

Fork the repository
Clone your fork: git clone https://github.com/your-username/flutter_wallet_card.git
Install dependencies: flutter pub get
Run tests: flutter test
Start documentation server: ./scripts/deploy-docs.sh dev

Before Submitting

Run ./scripts/publish-package.sh validate to ensure quality
Update documentation if needed
Add tests for new features
Follow existing code style

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

📧 Email: michal.makowski97@gmail.com
🐛 Issues: GitHub Issues
💬 Discussions: GitHub Discussions

Changelog

See CHANGELOG.md for a detailed list of changes.

Made with ❤️ for the Flutter community

Name		Name	Last commit message	Last commit date
Latest commit History 106 Commits
.github/workflows		.github/workflows
android		android
example		example
ios		ios
lib		lib
scripts		scripts
test		test
.gitignore		.gitignore
.metadata		.metadata
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
analysis_options.yaml		analysis_options.yaml
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

License

WebEferen/flutter_wallet_card

Folders and files

Latest commit

History

Repository files navigation

Flutter Wallet Card

Features

Cross-Platform Support

Card Operations

Card Types Supported

Advanced Features

Installation

Platform Setup

iOS Setup

Android Setup

Usage

Basic Example

Advanced Usage

Creating Cards with Locations

Generating Card Files

Downloading Cards from URLs

Platform-Specific Features

API Reference

Core Methods

iOS-Specific Methods

Android-Specific Methods

Models

WalletCard

WalletCardMetadata

WalletCardVisuals

Error Handling

Testing

Migration from v3.x

Breaking Changes

Migration Example

Development Resources

🚀 Development & Deployment

Local Development

Publishing

Automated Workflows

Contributing

Development Setup

Before Submitting

License

Support

Changelog

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 3

Packages 0

Uh oh!

Contributors 5

Uh oh!

Languages

Packages