# quadrified/react-native-image-crop-picker architecture

> Architecture diagram of the GitHub repository quadrified/react-native-image-crop-picker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/quadrified/react-native-image-crop-picker
- Repository: https://github.com/quadrified/react-native-image-crop-picker

## Overview

react-native-image-crop-picker is a React Native library for selecting images or video from a gallery or camera, cropping images, and returning file metadata or optional base64/EXIF data. Its workflow is JavaScript API → native module → platform picker/camera/crop handling → result; temporary-file cleanup is also exposed. Android implementation relationships are supported by sampled source and the SOURCE INDEX. The README documents iOS support, but the supplied iOS files are headers and do not establish internal runtime call paths, so that branch is shown as unverified.

Main entry points: [`android/src/main/java/com/reactnative/ivpusic/imagepicker/ImageCropPicker.java`](https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/main/java/com/reactnative/ivpusic/imagepicker/ImageCropPicker.java) (Picker engine), [`index.js`](https://github.com/quadrified/react-native-image-crop-picker/blob/master/index.js) (Picker API), [`src/NativeImageCropPicker.ts`](https://github.com/quadrified/react-native-image-crop-picker/blob/master/src/NativeImageCropPicker.ts) (Native spec), [`ios/src`](https://github.com/quadrified/react-native-image-crop-picker/tree/master/ios/src) (iOS picker and crop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_js["JavaScript API"]
  node_api["Picker API<br/>[index.js]"]
  node_spec["Native spec"]
end

subgraph group_android["Android runtime"]
  node_oldbridge["Legacy bridge<br/>[PickerModule.java]"]
  node_newbridge["New-arch bridge<br/>[PickerModule.java]"]
  node_picker["Picker engine"]
end

subgraph group_processing["Media processing"]
  node_results["Result collector"]
  node_paths["URI path resolver<br/>[RealPathUtil.java]"]
  node_compression["Image compression<br/>[Compression.java]"]
  node_exif["EXIF extraction<br/>[ExifExtractor.java]"]
  node_geo["GPS extraction<br/>[GeoDegree.java]"]
end

subgraph group_ios["iOS runtime"]
  node_iospicker["iOS picker and crop"]
  node_qbpicker["Album selection UI"]
  node_ioscompression["iOS image processing<br/>[Compression.h]"]
end

node_user(("App developer"))
node_result["Picked media"]

node_user -->|"calls"| node_api
node_api -->|"exports"| node_spec
node_spec -.->|"declares methods"| node_oldbridge
node_spec -.->|"declares methods"| node_newbridge
node_oldbridge -->|"delegates"| node_picker
node_newbridge -->|"delegates"| node_picker
node_picker -->|"reports results"| node_results
node_picker -->|"resolves URIs"| node_paths
node_picker -->|"compresses media"| node_compression
node_picker -->|"extracts metadata"| node_exif
node_exif -->|"reads coordinates"| node_geo
node_picker -->|"returns media"| node_result
node_api -.->|"uses platform runtime"| node_iospicker
node_iospicker -.->|"uses album UI"| node_qbpicker
node_iospicker -.->|"processes images"| node_ioscompression

click node_api "https://github.com/quadrified/react-native-image-crop-picker/blob/master/index.js"
click node_spec "https://github.com/quadrified/react-native-image-crop-picker/blob/master/src/NativeImageCropPicker.ts"
click node_oldbridge "https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/oldArch/java/com/reactnative/ivpusic/imagepicker/PickerModule.java"
click node_newbridge "https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/newArch/java/com/reactnative/ivpusic/imagepicker/PickerModule.java"
click node_picker "https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/main/java/com/reactnative/ivpusic/imagepicker/ImageCropPicker.java"
click node_results "https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/main/java/com/reactnative/ivpusic/imagepicker/ResultCollector.java"
click node_paths "https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/main/java/com/reactnative/ivpusic/imagepicker/RealPathUtil.java"
click node_compression "https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/main/java/com/reactnative/ivpusic/imagepicker/Compression.java"
click node_exif "https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/main/java/com/reactnative/ivpusic/imagepicker/ExifExtractor.java"
click node_geo "https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/main/java/com/reactnative/ivpusic/imagepicker/GeoDegree.java"
click node_iospicker "https://github.com/quadrified/react-native-image-crop-picker/tree/master/ios/src"
click node_qbpicker "https://github.com/quadrified/react-native-image-crop-picker/tree/master/ios/QBImagePicker/QBImagePicker"
click node_ioscompression "https://github.com/quadrified/react-native-image-crop-picker/blob/master/ios/src/Compression.h"

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_api,node_spec toneBlue
class node_oldbridge,node_newbridge,node_picker toneAmber
class node_results,node_paths,node_compression,node_exif,node_geo toneMint
class node_iospicker,node_qbpicker,node_ioscompression toneRose
class node_user,node_result toneIndigo
```

## Components

### JavaScript API

- [Picker API](https://github.com/quadrified/react-native-image-crop-picker/blob/master/index.js): `index.js`
- [Native spec](https://github.com/quadrified/react-native-image-crop-picker/blob/master/src/NativeImageCropPicker.ts): `src/NativeImageCropPicker.ts`

### Android runtime

- [Legacy bridge](https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/oldArch/java/com/reactnative/ivpusic/imagepicker/PickerModule.java): `android/src/oldArch/java/com/reactnative/ivpusic/imagepicker/PickerModule.java`
- [New-arch bridge](https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/newArch/java/com/reactnative/ivpusic/imagepicker/PickerModule.java): `android/src/newArch/java/com/reactnative/ivpusic/imagepicker/PickerModule.java`
- [Picker engine](https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/main/java/com/reactnative/ivpusic/imagepicker/ImageCropPicker.java): `android/src/main/java/com/reactnative/ivpusic/imagepicker/ImageCropPicker.java`

### Media processing

- [Result collector](https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/main/java/com/reactnative/ivpusic/imagepicker/ResultCollector.java): `android/src/main/java/com/reactnative/ivpusic/imagepicker/ResultCollector.java`
- [URI path resolver](https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/main/java/com/reactnative/ivpusic/imagepicker/RealPathUtil.java): `android/src/main/java/com/reactnative/ivpusic/imagepicker/RealPathUtil.java`
- [Image compression](https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/main/java/com/reactnative/ivpusic/imagepicker/Compression.java): `android/src/main/java/com/reactnative/ivpusic/imagepicker/Compression.java`
- [EXIF extraction](https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/main/java/com/reactnative/ivpusic/imagepicker/ExifExtractor.java): `android/src/main/java/com/reactnative/ivpusic/imagepicker/ExifExtractor.java`
- [GPS extraction](https://github.com/quadrified/react-native-image-crop-picker/blob/master/android/src/main/java/com/reactnative/ivpusic/imagepicker/GeoDegree.java): `android/src/main/java/com/reactnative/ivpusic/imagepicker/GeoDegree.java`

### iOS runtime

- [iOS picker and crop](https://github.com/quadrified/react-native-image-crop-picker/tree/master/ios/src): `ios/src`
- [Album selection UI](https://github.com/quadrified/react-native-image-crop-picker/tree/master/ios/QBImagePicker/QBImagePicker): `ios/QBImagePicker/QBImagePicker`
- [iOS image processing](https://github.com/quadrified/react-native-image-crop-picker/blob/master/ios/src/Compression.h): `ios/src/Compression.h`

### Other components

- **App developer**
- **Picked media**

## Connections

- App developer → Picker API: calls (evidence: `README.md`)
- Picker API → Native spec: exports (evidence: `index.js`)
- Native spec → Legacy bridge: declares methods
- Native spec → New-arch bridge: declares methods
- Legacy bridge → Picker engine: delegates (evidence: `android/src/oldArch/java/com/reactnative/ivpusic/imagepicker/PickerModule.java`)
- New-arch bridge → Picker engine: delegates (evidence: `android/src/newArch/java/com/reactnative/ivpusic/imagepicker/PickerModule.java`)
- Picker engine → Result collector: reports results (evidence: `android/src/main/java/com/reactnative/ivpusic/imagepicker/ImageCropPicker.java`)
- Picker engine → URI path resolver: resolves URIs (evidence: `android/src/main/java/com/reactnative/ivpusic/imagepicker/ImageCropPicker.java`)
- Picker engine → Image compression: compresses media (evidence: `android/src/main/java/com/reactnative/ivpusic/imagepicker/ImageCropPicker.java`)
- Picker engine → EXIF extraction: extracts metadata (evidence: `android/src/main/java/com/reactnative/ivpusic/imagepicker/ImageCropPicker.java`)
- EXIF extraction → GPS extraction: reads coordinates (evidence: `android/src/main/java/com/reactnative/ivpusic/imagepicker/ExifExtractor.java`)
- Picker engine → Picked media: returns media (evidence: `android/src/main/java/com/reactnative/ivpusic/imagepicker/ImageCropPicker.java`)
- Picker API → iOS picker and crop: uses platform runtime
- iOS picker and crop → Album selection UI: uses album UI
- iOS picker and crop → iOS image processing: processes images
