# kawaki0101/flot-design architecture

> Architecture diagram of the GitHub repository kawaki0101/flot-design, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kawaki0101/flot-design
- Repository: https://github.com/kawaki0101/flot-design

## Overview

##### Project Type and Purpose
- This is a React Native mobile application targeting both Android and iOS platforms.
- It implements a multi-step loan application flow (intro screens, login/OTP, KYC/Aadhaar verification, selfie upload, loan application, confirmation, and dashboard).
- The project uses JavaScript/TypeScript (TSX) for UI and business logic, with native wrappers (Kotlin/Swift) for platform integration.

##### High-Level File Structure Analysis
- Top-level native folders:
- android/ – Android project, Gradle build scripts, MainActivity.kt, MainApplication.kt
- ios/ – iOS Xcode project, AppDelegate.swift, Info.plist, CocoaPods setup
- JS/TS source folder:
- src/
– Screens/ – UI screens organized by feature flow
– components/ – Reusable UI components (headers, inputs, banners)
– navigation/ – React Navigation setup (AppNavigator.js, BottomTabNavigation.js)
– utils/ – Helpers, custom hooks, constants, theming, scaling, date utils
– hooks/ – Custom hooks (e.g. back button handler)
– assets/, animations/, DummyData/ – Static assets, Lottie animations, mock data
- Configuration and tooling:
- metro.config.js, babel.config.js, jest.config.js, tsconfig.json
- package.json defining dependencies (react-native, react-navigation, etc.)
- build scripts and linters (.eslintrc.js, .prettierrc.js)

##### Key Components
a. Native Shells
- Android Layer (Gradle, MainActivity → ReactRootView)
- iOS Layer (Xcode, AppDelegate → RCTRootView)
b. JS Runtime & Bundler
- Metro Bundler / JavaScriptCore or Hermes VM
- Bundled JS/TS code (App.tsx entry point)
c. React Native Bridge
- Communication channel between JS code and native modules (camera, file, networking)
d. Application Modules
- Navigation Module
- AppNavigator (stack navigator for flows)
- BottomTabNavigation (dashboard tabs)
- UI Screens
- Intro, Login/OTP, Aadhaar Verification, KYC Details, Selfie Upload, Apply Loan, Confirm Address, Dashboard (History, Info, Payments)
- Shared Components
- AppHeader, OTPInput, NetworkStatusBanner, CustomButton/Input/Map/Text
- Utilities & Hooks
- Constants, DateUtils, Themes, Scaling, NavigationUtils, useBackButtonExitApp, useKeyboardOffsetHeight
- Data Layer
- Remote API service calls (not in source tree but implied)
- DummyData folder for local mocking in development
e. Assets & Animations
- Lottie JSON files under src/animations
- Images under src/assets/Image

##### Relationships and Data Flow
1. User taps on device → Native event captured in React Native bridge
2. JS runtime processes event → React Navigation directs to the appropriate Screen
3. Screen components call utils/hooks for form state, validation, and networking (via fetch/axios)
4. API requests flow out to external backend services (authentication, Aadhaar, loan processing)
5. Responses update application state → UI updates via component re-render
6. Assets (images, animations) are loaded locally from the bundle

##### Architectural Patterns & Principles
- Modular folder structure by feature (screens) and concern (components, utils, hooks)
- Single source of truth via navigation state managed by React Navigation
- Separation of presentation (components/screens) from business logic (utils/services)
- Use of custom hooks for cross-cutting concerns (keyboard offset, back-button handling)
- Mock data layering for offline development/testing

## Diagram (Mermaid)

```mermaid
graph TB
  subgraph "Native Shells"
    Android("Android Layer"):::native
    iOS("iOS Layer"):::native
  end

  subgraph "JS Runtime & Bridge"
    Bundler("Metro Bundler"):::js
    AppEntry("App.tsx"):::js
    Index("index.js"):::js
    MetroConfig("metro.config.js"):::js
    JSVM("JS VM (JSC/Hermes)"):::js
    Bridge("React Native Bridge"):::js
  end

  subgraph "Application Modules"
    subgraph "Navigation Module"
      AppNav("AppNavigator"):::app
      TabNav("BottomTabNavigation"):::app
    end
    subgraph "Screens"
      IntroScreen("IntroScreen"):::app
      LoginScreen("LoginScreen"):::app
      OtpScreen("OtpScreen"):::app
      AadhaarVer("AadhaarVerificationScreen"):::app
      AadhaarOtp("AadhaarOtpVerificationScreen"):::app
      KycDetails("KYCDetailsScreen"):::app
      BasicDetails("SubmitBasicDetailsScreen"):::app
      SelfieUpload("SelfieUploadScreen"):::app
      ApplyLoan("ApplyLoanScreen"):::app
      ConfirmAddress("ConfirmAddressScreen"):::app
      AddressConfirm("AddressConfirmScreen"):::app
      Dashboard("DashboardScreen"):::app
      History("History"):::app
      Info("Information"):::app
      Payment("Payment"):::app
      Splash("SplashScreen"):::app
      Reject("LoanRejectedScreen"):::app
    end
    subgraph "Shared Components"
      AppHeader("AppHeader"):::app
      OTPInput("OTPInput"):::app
      NetworkBanner("NetworkStatusBanner"):::app
    end
    subgraph "Utils & Hooks"
      Constants("Constants"):::app
      DateUtils("DateUtils"):::app
      Themes("Themes"):::app
      Scaling("Scaling"):::app
      NavUtils("NavigationUtils"):::app
      Helper("helper"):::app
      GetPoints("getPoints"):::app
      CustomButton("CustomButton"):::app
      CustomInput("CustomInput"):::app
      CustomMap("CustomMap"):::app
      CustomText("CustomText"):::app
      UseBack("useBackButtonExitApp"):::app
      UseKeyboard("useKeyboardOffsetHeight"):::app
    end
    subgraph "Mock Data & Assets"
      DummyDash("DashboardDummyData"):::app
      DummyAad("DummyAadhaarData"):::app
      DummyBasic("DummyBasicDetails"):::app
      DummyHist("DummyHistoryData"):::app
      DummyOtp("DummyOtpData"):::app
      DummyPay("DummyPaymentData"):::app
      Animations("Animations Folder"):::app
      Assets("Assets Folder"):::app
    end
  end

  subgraph "External Services"
    AuthAPI("Auth API"):::external
    AadhaarService("Aadhaar Service"):::external
    LoanService("Loan Service"):::external
  end

  Android -->|"launches ReactRootView"| JSVM
  iOS -->|"launches RCTRootView"| JSVM
  Bundler -->|bundle| JSVM
  AppEntry --> JSVM
  Index --> JSVM
  MetroConfig --> Bundler
  JSVM -->|bridge| Bridge
  Bridge -- bidirectional --> Android
  Bridge -- bidirectional --> iOS
  Bridge -->|"start app"| AppNav
  AppNav -->|"stack nav"| IntroScreen
  IntroScreen --> LoginScreen
  LoginScreen --> OtpScreen
  OtpScreen --> AadhaarVer
  AadhaarVer --> AadhaarOtp
  AadhaarOtp --> KycDetails
  KycDetails --> BasicDetails
  BasicDetails --> SelfieUpload
  SelfieUpload --> ApplyLoan
  ApplyLoan --> ConfirmAddress
  ConfirmAddress --> AddressConfirm
  AddressConfirm --> Dashboard
  Dashboard --> History
  Dashboard --> Info
  Dashboard --> Payment

  OtpScreen -->|"API call"| AuthAPI
  AadhaarVer -->|"API call"| AadhaarService
  AadhaarOtp -->|"OTP verify"| AadhaarService
  ApplyLoan -->|"submit loan"| LoanService
  LoanService -->|"response"| Dashboard
  JSVM -->|"fetch/axios"| AuthAPI
  JSVM -->|"fetch/axios"| AadhaarService
  JSVM -->|"fetch/axios"| LoanService
  IntroScreen -->|"load assets"| Assets
  IntroScreen -->|"load anims"| Animations

  classDef native fill:#d3d3d3,stroke:#333,stroke-width:1px;
  classDef js fill:#bbdefb,stroke:#333,stroke-width:1px;
  classDef app fill:#c8e6c9,stroke:#333,stroke-width:1px;
  classDef external fill:#ffcc80,stroke:#333,stroke-width:1px;

  click Android "https://github.com/kawaki0101/flot-design/blob/main/android/app/src/main/java/com/myapp/MainActivity.kt"
  click iOS "https://github.com/kawaki0101/flot-design/blob/main/ios/myApp/AppDelegate.swift"
  click AppEntry "https://github.com/kawaki0101/flot-design/blob/main/App.tsx"
  click Index "https://github.com/kawaki0101/flot-design/blob/main/index.js"
  click MetroConfig "https://github.com/kawaki0101/flot-design/blob/main/metro.config.js"
  click AppNav "https://github.com/kawaki0101/flot-design/blob/main/src/navigation/AppNavigator.js"
  click TabNav "https://github.com/kawaki0101/flot-design/blob/main/src/navigation/BottomTabNavigation.js"
  click IntroScreen "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/Intro/IntroScreen.js"
  click LoginScreen "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/Login/LoginScreen.js"
  click OtpScreen "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/OTP/OtpScreen.js"
  click AadhaarVer "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/AadhaarVerification/AadhaarVerificationScreen.js"
  click AadhaarOtp "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/AadhaarVerification/AadhaarOtpVerificationScreen.js"
  click KycDetails "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/KYCDetailsScreen/KYCDetailsScreen.js"
  click BasicDetails "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/ProfeDetails/SubmitBasicDetailsScreen.js"
  click SelfieUpload "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/SelfyScreen/SelfieUploadScreen.js"
  click ApplyLoan "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/ApplyScreen/ApplyLoanScreen.js"
  click ConfirmAddress "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/ConformationScreen/ConfirmAddressScreen.js"
  click AddressConfirm "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/ConformationScreen/AddressConfirmScreen.js"
  click Dashboard "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/Dashboard/DashboardScreen.js"
  click History "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/Dashboard/History.js"
  click Info "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/Dashboard/Information.js"
  click Payment "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/Dashboard/Payment.js"
  click Splash "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/Splash/SplashScreen.js"
  click Reject "https://github.com/kawaki0101/flot-design/blob/main/src/Screens/RejectScreen/LoanRejectedScreen.js"
  click AppHeader "https://github.com/kawaki0101/flot-design/blob/main/src/components/AppHeader.js"
  click OTPInput "https://github.com/kawaki0101/flot-design/blob/main/src/components/OTPInput.js"
  click NetworkBanner "https://github.com/kawaki0101/flot-design/blob/main/src/components/NetworkStatusBanner.js"
  click Constants "https://github.com/kawaki0101/flot-design/blob/main/src/utils/Constants.tsx"
  click DateUtils "https://github.com/kawaki0101/flot-design/blob/main/src/utils/DateUtils.tsx"
  click Themes "https://github.com/kawaki0101/flot-design/blob/main/src/utils/Themes.tsx"
  click Scaling "https://github.com/kawaki0101/flot-design/blob/main/src/utils/Scaling.tsx"
  click NavUtils "https://github.com/kawaki0101/flot-design/blob/main/src/utils/NavigationUtils.tsx"
  click Helper "https://github.com/kawaki0101/flot-design/blob/main/src/utils/helper.tsx"
  click GetPoints "https://github.com/kawaki0101/flot-design/blob/main/src/utils/getPoints.js"
  click CustomButton "https://github.com/kawaki0101/flot-design/blob/main/src/utils/CustomButton.tsx"
  click CustomInput "https://github.com/kawaki0101/flot-design/blob/main/src/utils/CustomInput.tsx"
  click CustomMap "https://github.com/kawaki0101/flot-design/blob/main/src/utils/CustomMap.tsx"
  click CustomText "https://github.com/kawaki0101/flot-design/blob/main/src/utils/CustomText.tsx"
  click UseBack "https://github.com/kawaki0101/flot-design/blob/main/src/hooks/useBackButtonExitApp.js"
  click UseKeyboard "https://github.com/kawaki0101/flot-design/blob/main/src/utils/useKeyboardOffsetHeight.tsx"
  click DummyDash "https://github.com/kawaki0101/flot-design/blob/main/src/DummyData/DashboardDummyData.js"
  click DummyAad "https://github.com/kawaki0101/flot-design/blob/main/src/DummyData/DummyAadhaarData.js"
  click DummyBasic "https://github.com/kawaki0101/flot-design/blob/main/src/DummyData/DummyBasicDetails.js"
  click DummyHist "https://github.com/kawaki0101/flot-design/blob/main/src/DummyData/DummyHistoryData.js"
  click DummyOtp "https://github.com/kawaki0101/flot-design/blob/main/src/DummyData/DummyOtpData.js"
  click DummyPay "https://github.com/kawaki0101/flot-design/blob/main/src/DummyData/DummyPaymentData.js"
  click Animations "https://github.com/kawaki0101/flot-design/tree/main/src/animations"
  click Assets "https://github.com/kawaki0101/flot-design/tree/main/src/assets/Image"
```
