# expo-hamro-image-picker

> A Image Picker/Selector library for react native expo

Latest version **0.0.2** (published 2022-12-22) · MIT license · 0 weekly downloads

## Install

```sh
npm install expo-hamro-image-picker
pnpm add expo-hamro-image-picker
yarn add expo-hamro-image-picker
bun add expo-hamro-image-picker
```

## Health

**Score 20/100 (F)** — status: abandoned.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.2 |
| Published | 2022-12-22 |
| First published | 2022-12-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 15 |
| Unpacked size | 180.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Sunil Baral |
| Maintainers | snlbaral |
| Keywords | expo, react native, expo image picker, image picker, expo image selector, image picker |

## Links

- npm: https://www.npmjs.com/package/expo-hamro-image-picker
- Repository: https://github.com/snlbaral/expo-hamro-image-picker
- Homepage: https://github.com/snlbaral/expo-hamro-image-picker#readme
- Issues: https://github.com/snlbaral/expo-hamro-image-picker/issues
- npm.io page: https://npm.io/package/expo-hamro-image-picker

## Dependencies (15)

- [recoil](https://npm.io/package/recoil.md) ^0.7.6
- [expo-gl](https://npm.io/package/expo-gl.md) ^12.0.1
- [react-dom](https://npm.io/package/react-dom.md) ^16.13.1
- [expo-asset](https://npm.io/package/expo-asset.md) ^8.6.2
- [expo-gl-cpp](https://npm.io/package/expo-gl-cpp.md) ^11.4.0
- [expo-file-system](https://npm.io/package/expo-file-system.md) ^15.1.1
- [react-native-web](https://npm.io/package/react-native-web.md) ^0.13.12
- [expo-image-editor](https://npm.io/package/expo-image-editor.md) ^1.7.1
- [expo-image-picker](https://npm.io/package/expo-image-picker.md) ^14.0.2
- [@expo/vector-icons](https://npm.io/package/@expo/vector-icons.md) ^13.0.0
- [expo-media-library](https://npm.io/package/expo-media-library.md) ^15.0.0
- [react-native-modalbox](https://npm.io/package/react-native-modalbox.md) ^2.0.2
- [expo-image-manipulator](https://npm.io/package/expo-image-manipulator.md) ^11.0.0
- [react-native-gesture-handler](https://npm.io/package/react-native-gesture-handler.md) ^2.8.0
- [modal-enhanced-react-native-web](https://npm.io/package/modal-enhanced-react-native-web.md) ^0.2.0

## Alternatives

- [exif-parser](https://npm.io/package/exif-parser.md) — 3.8M weekly downloads
- [vite-plugin-compression](https://npm.io/package/vite-plugin-compression.md) — 569.5K weekly downloads
- [pica](https://npm.io/package/pica.md) — 442.4K weekly downloads
- [@reportportal/client-javascript](https://npm.io/package/@reportportal/client-javascript.md) — 408.8K weekly downloads
- [@tldraw/state](https://npm.io/package/@tldraw/state.md) — 316.0K weekly downloads

## Recent versions

- 0.0.2 (latest) — 2022-12-22
- 0.0.16 — 2022-12-20
- 0.0.15 — 2022-12-20
- 0.0.14 — 2022-12-20
- 0.0.13 — 2022-12-20
- 0.0.12 — 2022-12-20
- 0.0.11 — 2022-12-20
- 0.0.1 — 2022-12-20

## README

# expo-hamro-image-picker

Dynamic Image/Files Picker For Expo

| ![1](/examples/screenshots/1.jpeg) | ![2](/examples/screenshots/2.jpeg) | ![3](/examples/screenshots/3.jpeg) | ![4](/examples/screenshots/4.jpeg) |
| ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |



## Installation

To get started install the package in your Expo project by running:

```
yarn add expo-hamro-image-picker
```

or

```
npm i expo-hamro-image-picker
```

## Basic Usage

```js
import React from 'react';
import { View, Button } from 'react-native';
import ExpoHamroImagePicker from 'expo-hamro-image-picker';

export default function Test() {
    const [showPicker, setShowPicker] = useState(false);

    const handleSubmit = (data) => {
        console.log(data)
    }

    render() {
        return (
            <View style={{ flex: 1, backgroundColor: '#000000' }}>
                <ExpoHamroImagePicker
                    handlePickerClose={()=>{
                        console.log("picker closed");
                        setShowPicker(false);
                    }}
                    enablePicker={showPicker}
                    handleSubmit={handleSubmit}
                    enableEditor={true}
                    enableMultiSelect={true}
                    headerText="New Image"
                />
                <Button title="Open Image Picker" onPress={()=>setShowPicker(true)}/>
            </View>
        )
    }
}
```
## Props

| Parameter     | type  | required |  default | description   |
| ------------- | ----- | -------- | -------- | ------------- |
| enablePicker|boolean|Yes||open/hide image picker|
| headerText|string|No|New Post|header text shows at top|
| enableAlbums|boolean|No|true|allows select albums|
| enableCameraCapture|boolean|No|true|allows capture image using camera|
| enableMultiSelect|boolean|No|false|allows select multiple image/file|
| multiSelectOptions|MultiSelectOptionsProps|No|```{ minimumImageCount: 1, maximumImageCount: -1 }```|configuration for multi image/file select|
| backButtonClose|boolean|No|true|close image picker on back button press|
| coverScreen|boolean|No|true|covers entire screen|
| swipeToClose|boolean|No|true|swipe down to close|
| multipleSelectEnabled|boolean|No|false|multiple image/file select enabled by default when picker opens|
| ImageComponent|Component|No|ImageBackground|allows to use different Image Component. i.e. Image/FastImage etc.|
| handlePickerClose|function|No|```()=>{console.log("picker closes")}```|triggers when picker closes|
| handleSubmit|function|No|```(data)=>{console.log("picked image", data)}```|triggers when everything is done|
| enableEditor|boolean|No|true|enable editor to allow edit picked image|
| editorOptions|ImageEditorProps|No|```{fixedCropAspectRatio={16 / 9} lockAspectRatio={false}}```|Image Editor Configurations: https://github.com/thomas-coldwell/expo-image-editor|

## Contributing

See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.

## License

MIT

---
_Source: https://npm.io/package/expo-hamro-image-picker · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._