> ## Documentation Index
> Fetch the complete documentation index at: https://bkey.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# BMONI Embedded — overview

> Flutter packages for embedded Ethereum wallets, UI components, and wallet card widgets.

BMONI Embedded is a suite of Flutter packages that lets you add self-custodied Ethereum wallets, a production-grade design system, and ready-to-wire wallet card widgets to any Flutter app.

## Start here

Every integration walks the same six stages in the same order. Read the lifecycle once, then jump to the goal you are building.

<CardGroup cols={2}>
  <Card title="The integration lifecycle" icon="route" href="/lifecycle">
    User → wallet → KYC → rail → fund → move money. What each stage needs before it works, and what it leaves you with.
  </Card>

  <Card title="Start from a goal" icon="bullseye" href="/use-cases">
    USD accounts, Nigerian withdrawals, MXN ramps, SEPA payouts, or onboarding users with no app of your own.
  </Card>
</CardGroup>

## The packages

<CardGroup cols={2}>
  <Card title="bmoni_embedded_sdk" icon="shield-keyhole" href="/sdk/introduction">
    Provision secp256k1 wallets and sign Ethereum transactions on-device. Private keys never leave Android Keystore / iOS Secure Enclave.
  </Card>

  <Card title="bkey_uikit" icon="palette" href="/uikit/introduction">
    BMONI design system for Flutter — colours, typography, theming, and every UI primitive used across Bkey products.
  </Card>

  <Card title="bmoni_embedded_wallets_cards" icon="credit-card" href="/wallets/introduction">
    Model-aware wallet card widgets, Riverpod notifiers, and pluggable data contracts built on top of `bkey_uikit`.
  </Card>

  <Card title="API" icon="server" href="/api-reference/introduction">
    REST API that backs the embedded wallet product. Full interactive reference hosted separately.
  </Card>
</CardGroup>

***

## How the packages relate

```
┌──────────────────────────────────────────────────────────┐
│  Your app  ·  routing  ·  l10n  ·  analytics  ·  auth   │
├──────────────────────────────────────────────────────────┤
│  bmoni_embedded_wallets_cards                            │
│  · EmbeddedWallet models  · Riverpod notifiers          │
│  · EmbeddedWalletCard  · EmbeddedWalletTransactionsSection│
├──────────────────────────────────────────────────────────┤
│  bkey_uikit                                              │
│  · BMoniColors / BMoniTextStyles / BMoniTheme            │
│  · Buttons, forms, sheets, feedback, wallet card         │
├──────────────────────────────────────────────────────────┤
│  bmoni_embedded_sdk                                      │
│  · BmoniEmbeddedSdk  (wallet + PIN + signing)            │
│  · Android Keystore  /  iOS Secure Enclave               │
└──────────────────────────────────────────────────────────┘
```

Each layer is independently installable. You can use `bkey_uikit` without `bmoni_embedded_sdk`, or use `bmoni_embedded_sdk` headlessly in a custom UI.

***

## Quick links

| Task                                  | Where to go                                     |
| ------------------------------------- | ----------------------------------------------- |
| Add a self-custodied wallet to my app | [Quickstart](/quickstart)                       |
| Provision a wallet on-device          | [Wallet provisioning](/sdk/wallet-provisioning) |
| Sign a message or transaction         | [Signing](/sdk/signing)                         |
| Apply the BMONI theme                 | [UI Kit — installation](/uikit/installation)    |
| Render a wallet card                  | [Wallet card widget](/wallets/widgets)          |
| Call the REST API                     | [API reference](/api-reference/introduction)    |