https://github.com/pierrecapo/react-native-pictures
https://github.com/pierrecapo/react-native-pictures
Last synced: 11 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/pierrecapo/react-native-pictures
- Owner: PierreCapo
- License: mit
- Created: 2023-12-28T20:30:40.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-29T23:07:08.000Z (over 1 year ago)
- Last Synced: 2025-06-25T14:50:53.800Z (12 months ago)
- Language: Swift
- Size: 1.46 MB
- Stars: 51
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# React-Native-Pictures
React Native Pictures is a comprehensive toolkit for handling images within your React Native application. Our goal is to provide a modern, efficient codebase using Swift and Kotlin, offering common solutions for image-related features in your React Native app.
This library integrates a custom native iOS implementation and utilizes [PhotoView](https://github.com/Baseflow/PhotoView) on Android. Please note that this project is in its early stages—expect breaking changes before the release of v1.
## Installation
```sh
npm install react-native-pictures
```
## Usage
Here's a simple example to showcase how you can use React Native Pictures in your app.
It's recommended that the viewer takes the entire available space:
```js
import {PicturesViewer} from 'react-native-pictures';
// ...
```
## API
### PicturesViewer
| Props | Type | Description |
| --- | --- | --- |
| imageUrl | string | The remote image url you want to see |
| style | ViewStyle | Style of PictureViewer.
## Roadmap
- **More controls:** Add ability to display local images, gesture event listeners, etc.
- **Custom Android Implementation:** Replace PhotoView with a custom implementation, as PhotoView is no longer maintained.
- **Image Cropping Feature:** Implement a cropping feature to leverage the pan and zoom capabilities, making it easier to integrate an image cropping screen.
## Contributing
See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
## License
MIT
---
Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)