expo-image-crop

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

expo-image-crop

★ 111 Open GitHub ↗

Crop and rotate image without detach your expo project!

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Expo image manipulator</h1>
<p align="center">Multi platform 🚀</p>

<p align="center">
   <img width="250" src="./demo.gif"/>
   <br/>
   <br/>
   <br/>
   <br/>
   <a href="https://github.com/brunon80/expo-image-crop"><img alt="npm version" src="https://badge.fury.io/js/expo-image-crop.svg"/>
   <a href="https://github.com/brunon80/expo-image-crop"><img alt="npm version" src="https://img.shields.io/badge/platform-ios%2Fandroid-blue.svg"/>
   <a href="https://github.com/brunon80/expo-image-crop"><img alt="npm version" src="https://img.shields.io/badge/license-MIT-lightgrey.svg"/>
   <p align="center">
   
  <a href="https://exp.host/@koruja/expo-image-crop">Open on your device!</a>
</p>
</a>
</p>

## Crop and rotate image without detach your expo project!
## `Expo.ImageManipulator` is only an API, so it does not contain a UI. You will have to build your own UI on top of it, or choose to detach your project and use third party linked packages, which is not as good because a pure javascript Expo project is marvelous!

[PRs are welcome...](https://github.com/brunon80/expo-image-crop/pulls)

>No more flickering while resizing image mask!

>Compatible with Expo SDK 36

> Atention: *squareAspect* was removed on this version and will be add in future versions, if you need it, please stay at 0.2.17

### Expo Dependences
- yarn add react-native-vector-icons
- expo install expo-permissions
- expo install expo-image-picker
- expo install expo-file-system
- expo install expo-image-manipulator

## Example

```javascript
import React from 'react'
import { Dimensions, Button, ImageBackground } from 'react-native'
import { ImageManipulator } from 'expo-image-crop'

export default class App extends React.Component {
  state = {
      isVisible: false,
      uri: 'https://i.pinimg.com/originals/39/42/a1/3942a180299d5b9587c2aa8e09d91ecf.jpg',
  }
  onToggleModal = () => {
      const { isVisible } = this.state
      this.setState({ isVisible: !isVisible })
  }
  render() {
      const { uri, isVisible } = this.state
      const { width, height } = Dimensions.get('window')
      return (
          <ImageBackground
              resizeMode="contain"
              style={{
                  justifyContent: 'center', padding: 20, alignItems: 'center', height, width, backgroundColor: 'black',
              }}
              source={{ uri }}
          >
              <Button title="Open Image Editor" onPress={() => this.setState({ isVisible: true })} />
              <ImageManipulator
                  photo={{ uri }}
                  isVisible={isVisible}
                  onPictureChoosed={({ uri: uriM }) => this.setState({ uri: uriM })}
                  onToggleModal={this.onToggleModal}
              />
          </ImageBackground>
      )
  }
}
```

## Props
| Props            | Type     | Default                                                                    | Description                                        |
|------------------|----------|----------------------------------------------------------------------------|----------------------------------------------------|
| isVisible        | boolean  | false                                                                      | Show or hide modal with image manipulator UI       |
| onPictureChoosed | function |                                                                            | Callback where is passed image edited as parameter |
| photo            | object   | ```{  "uri": string } ```                                       | uri of image to be edited                          |
| btnTexts         | object   | ```{ "crop": string, "done": string, "processing": string}```    | name for crop, done and processing texts           |
| onToggleModal    | function |                                                                            | Callback called when modal is dismissed            |
| borderColor      | string   | #a4a4a4                                                                    | Color for crop mask border                         |
| allowRotate      | boolean  | true                                                                       | Show rotate option                                 |
| allowFlip        | boolean  | true                                                                       | Show flip option                                   |
| saveOptions      | object   | ```{ "compress": number, "format": string, "base64": boolean}``` | A map defining how modified image should be saved  
| fixedMask      | object   | ```{ "width": number, "height": number }``` | Width and height fixed mask

## Return of onPictureChoosed is an object with format:

```javascript
{
    uri: string,
    base64: string // undefined if base64 is false on saveOptions prop
}
```
## Run the example!
- Clone this repository
- cd example/
- run yarn or npm install
- enjoy!
### The animation is fluid even on dev mode!

## Requirements
* Use it into Expo app (from expo client, Standalone app or ExpoKit app).
* Because we need to have access to `ImageManipulator`

## Features
* Crop
* Rotate
* Flip (Horizontal and Vertical)
* Base64

## If you have some problem open a issue

expo-image-crop

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README