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

# Neobank iOS Demo

> A white-label neobank and smart-wallet starter built on the OMS mobile wallet foundation.

This demo is a React Native boilerplate for building branded crypto neobank apps on Polygon. You can use it as a full mobile wallet starter, or extract individual modules, auth, approvals, wallet data, WalletConnect, browser, funding, and earn, into an existing product.

## Tech stack

| Layer         | Choice                                                     |
| ------------- | ---------------------------------------------------------- |
| Framework     | React Native `0.83.2`                                      |
| Runtime       | Expo `~55.0.7`                                             |
| Language      | TypeScript `~5.9.2`                                        |
| Routing       | `expo-router` (file-based, typed routes)                   |
| Data fetching | TanStack Query `^5.90.20`                                  |
| Animation     | `react-native-reanimated` + `react-native-gesture-handler` |
| iOS target    | 15.1                                                       |
| Build         | Expo dev client, EAS workflow-ready                        |

## Features

<AccordionGroup>
  <Accordion title="Auth">
    * Google, Apple, and email OTP sign-in with local credential hints and re-login
    * Mnemonic create and import for recovery onboarding
    * Guard code handling for protected wallet flows
    * Local logout and wallet session reset
  </Accordion>

  <Accordion title="Wallet and portfolio">
    * Multi-network configuration via OMS runtime config
    * ERC-20 balance summary with fiat pricing
    * ERC-721 and ERC-1155 collectible inventory
    * Asset detail views for tokens and collectibles
    * Activity feed with indexed transfer history
    * Native transfer fallback for selected networks
  </Accordion>

  <Accordion title="Transactions and approvals">
    * Send flow with recipient-first UX
    * Coin and collectible send surfaces
    * Saved recipients and QR-based recipient scanning
    * Relayer-aware transaction submission
    * Approval surfaces for transaction requests, message signing, and typed data
    * Shared approval execution path reused by wallet, browser, and WalletConnect flows
  </Accordion>

  <Accordion title="Browser and WalletConnect">
    * Embedded dapp browser with tab management, history, bookmarks, and connected-site records
    * In-app RPC bridge for browser-originated wallet requests
    * WalletConnect pairing via QR scan or pasted URI
    * Proposal and request approval and rejection
    * Active session management and disconnect flows
  </Accordion>

  <Accordion title="Funding and earn">
    * Fiat-to-crypto on-ramp via Transak with wallet address prefill
    * Earn module backed by Yield.xyz: vault discovery, deposit, withdraw, position lookup, reward history
    * Persistent earn metadata and vault caching
  </Accordion>

  <Accordion title="Security">
    * OS-backed secure storage isolated from general cache layers
    * Screen-capture blocking on mnemonic screens
    * Sensitive logging redaction in auth flows
    * Runtime healthcheck for secure storage, SQLite, and MMKV
    * Explicit separation between local sign-out, cleanup, and session teardown
  </Accordion>
</AccordionGroup>

## Storage model

| Layer   | Technology               | Purpose                         |
| ------- | ------------------------ | ------------------------------- |
| Secrets | Secure OS-backed storage | Private keys, credentials       |
| State   | SQLite                   | Structured wallet and app state |
| Cache   | MMKV                     | Non-secret cache and UX state   |

## Integrations

Wallet Development Kit, OMS Indexer, OMS API, OMS Relayer, OMS Guard, WalletConnect (Reown), Yield.xyz, Transak.

<Note>
  The primary implementation targets native iOS. Expo web output is configured but the UX focus is mobile-first. Google, Apple, and email sign-in are implemented as iOS-native flows.
</Note>

## Get access

<Card title="Request access to this demo" icon="envelope" href="https://info.polygon.technology/get-early-access?utm_source=docs&utm_medium=card&utm_campaign=oms_access">
  Want to explore the neobank iOS demo? Contact us to request access.
</Card>