User App Overview

The Keshless User App is a mobile wallet application that enables users to manage digital funds, make payments, and perform financial transactions.

Features at a Glance

Feature	Description
Authentication	Login, register, OTP verification
KYC Verification	Identity verification flow
Wallet	Balance, transactions, QR codes
Payments	Airtime, bills, vendor payments
NFC Payments	Tap-to-pay with linked cards
Tickets	Event tickets purchase
Jobs	Verification jobs for agents

User Flow Overview

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Splash    │────▶│  Onboarding │────▶│   Login/    │
│   Screen    │     │   (new)     │     │  Register   │
└─────────────┘     └─────────────┘     └──────┬──────┘
                                               │
                   ┌───────────────────────────┘
                   ▼
           ┌─────────────┐     ┌─────────────┐
           │     KYC     │────▶│    Home     │
           │ Verification│     │  (Wallet)   │
           └─────────────┘     └──────┬──────┘
                                      │
       ┌──────────────┬───────────────┼───────────────┬──────────────┐
       ▼              ▼               ▼               ▼              ▼
 ┌──────────┐  ┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐
 │  Send    │  │ Receive  │   │ Payments │   │ Tickets  │   │  Jobs    │
 │  Money   │  │ (QR)     │   │ (Bills)  │   │          │   │          │
 └──────────┘  └──────────┘   └──────────┘   └──────────┘   └──────────┘

Security Features

Feature	Description
Biometric Authentication	Fingerprint/Face ID login
PIN Protection	Transaction PIN verification
Secure Storage	Encrypted local storage for sensitive data
Session Management	Automatic logout after inactivity
OTP Verification	Two-factor authentication for sensitive operations

Code Location

Repository Path: frontend/keshless-app/

Key Files:

File	Purpose
lib/main.dart	Entry point
lib/routes/app_routes.dart	Routes
lib/controllers/auth_controller.dart	Auth Controller
lib/controllers/wallet_controller.dart	Wallet Controller

API Integration

Endpoint	Purpose
/auth/*	Authentication flows
/users/*	User profile management
/wallet/*	Balance and transactions
/verification/*	KYC operations
/payments/*	Payment processing

Environment Configuration

Environment	API URL
Production	https://api.keshless.com
Development	https://dev-api.keshless.com