# nuriveben/ballerine-kyc-flow architecture

> Architecture diagram of the GitHub repository nuriveben/ballerine-kyc-flow, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nuriveben/ballerine-kyc-flow
- Repository: https://github.com/nuriveben/ballerine-kyc-flow

## Overview

This is a small Ballerine KYC-flow demo: its sole application entry point configures a French-language identity-verification flow and mounts it through the web SDK. The configured journey covers welcome, document selection and capture, review, loading, and a final screen. The SDK is a dependency, so its internal behavior and any downstream verification services are not visible in the supplied source.

Main entry points: [`src/main.ts`](https://github.com/nuriveben/ballerine-kyc-flow/blob/main/src/main.ts) (Flow configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["KYC demo"]
  node_config["Flow configuration<br/>[main.ts]"]
  node_journey["KYC journey steps<br/>[main.ts]"]
end

subgraph group_runtime["SDK runtime"]
  node_sdk["Ballerine web SDK"]
end

node_user(("End user"))

node_config -->|"defines steps"| node_journey
node_config -->|"initializes and mounts"| node_sdk
node_user -.->|"uses flow"| node_sdk

click node_config "https://github.com/nuriveben/ballerine-kyc-flow/blob/main/src/main.ts"
click node_journey "https://github.com/nuriveben/ballerine-kyc-flow/blob/main/src/main.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_config,node_journey,node_user toneBlue
class node_sdk toneAmber
```

## Components

### KYC demo

- [Flow configuration](https://github.com/nuriveben/ballerine-kyc-flow/blob/main/src/main.ts): `src/main.ts`
- [KYC journey steps](https://github.com/nuriveben/ballerine-kyc-flow/blob/main/src/main.ts): `src/main.ts`

### SDK runtime

- **Ballerine web SDK**

### Other components

- **End user**

## Connections

- Flow configuration → KYC journey steps: defines steps (evidence: `src/main.ts`)
- Flow configuration → Ballerine web SDK: initializes and mounts (evidence: `src/main.ts`)
- End user → Ballerine web SDK: uses flow
