Installation

Add bmoni_embedded_wallets_cards to your Flutter project.

Add the dependency

pubspec.yaml

dependencies:
  bmoni_embedded_wallets_cards: ^0.0.1

flutter pub get

---

Peer dependencies

bmoni_embedded_wallets_cards depends on:

Package	Why
bkey_uikit	UI primitives (BMoniWalletCard, colours, typography)
flutter_riverpod	StateNotifier-based notifiers
dartz	Either<EmbeddedFailure, T> for functional error handling
equatable	Value equality on models
json_annotation	JSON serialisation (generated, no manual setup needed)

All of these are pulled in automatically as transitive dependencies.

---

Riverpod setup

If you aren’t already using Riverpod, wrap your app root:

import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:bkey_uikit/bkey_uikit.dart';

void main() {
  runApp(
    const ProviderScope(
      child: EmbeddedWalletsApp(),
    ),
  );
}

class EmbeddedWalletsApp extends StatelessWidget {
  const EmbeddedWalletsApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: BMoniTheme.darkTheme(),
      home: const WalletsScreen(),
    );
  }
}

---

Import

import 'package:bmoni_embedded_wallets_cards/bmoni_embedded_wallets_cards.dart';

This single barrel exports everything: models, contracts, failures, notifiers, and widgets.

---

Run the example

A full Riverpod-wired example with in-memory fake data sources is in the example/ directory:

cd example
flutter pub get
flutter run

It demonstrates:

• A swipeable EmbeddedWalletCard carousel with show/hide balance
• An EmbeddedWalletTransactionsSection that follows the active wallet
• Pull-to-refresh fanning out across list, balance, and transaction notifiers
• In-memory EmbeddedWalletReadDataSource, EmbeddedWalletStorage, and EmbeddedWalletBalanceCache that run without a backend