🌟 Available Now on Android, with iOS Support Coming Soon! 🌟

🎨 Capacitor Image Cropper

The Capacitor Image Cropper plugin offers a powerful and user-friendly way to crop images in your mobile applications. With this plugin, you can effortlessly select and crop images to meet your desired dimensions, ensuring your app looks polished and professional! ✨

🚀 Features

• Flexible Cropping Options: Crop images with customizable width, height, and aspect ratios. 📏
• Quality Control: Adjust the quality of the resulting image, balancing fidelity and file size. 📸
• Circle Cropping: Optionally crop images in a circular shape for a unique visual flair. 🔵
• Cross-Platform Support: Works seamlessly on both iOS and Android platforms. 📱
• uCrop Integration: For Android, we utilize the powerful uCrop library, providing a robust and feature-rich cropping experience. 🎉

📚 Usage

To get started with the Capacitor Image Cropper plugin, simply install it in your project and follow the provided documentation for implementation details.

Transform your images effortlessly with the Capacitor Image Cropper plugin! 🌈

🛠️ Adding JitPack Repository

To add the JitPack repository, navigate to your android/gradle.build file and include the following configuration:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url "https://jitpack.io" }
    }
}

📦 Install

Run the following commands to install the plugin:

npm install capacitor-image-cropper
npx cap sync

📖 API

• crop(...)
• Interfaces

crop(...)

crop(options: CropOptions) => Promise<CropResult>

Param	Type
options	CropOptions

Returns: Promise<CropResult>

---

Interfaces

CropResult

Prop	Type	Description
path	string	The path to the cropped image On Android: content:// or file:// URI On iOS: file:// URI
base64	string	Base64 encoded image data (optional, web only)

CropOptions

Prop	Type	Description	Default
source	string	The path or url of the image to crop Can be a local file path, content:// uri, or file:// uri
quality	number	Quality of the resulting image, between 0-100	90
circle	boolean	Whether to crop the image in a circle	false
width	number	Maximum width of the resulting image	300
height	number	Maximum height of the resulting image	300
aspectRatioX	number	Aspect ratio X for crop box (width/height) e.g., 1 for square	1
aspectRatioY	number	Aspect ratio Y for crop box (height/width) e.g., 1 for square	1
activeControlsWidgetColor	string	Color of the active controls widget	"#9ef500"

---

👤 Author

Rahul Kumar Sharma

Passionate developer and creator of the Capacitor Image Cropper plugin.

💬 Message

Thank you for using the Capacitor Image Cropper! Your feedback and contributions are always welcome. Let's make image cropping a breeze for everyone! 🌟

🤝 Collaboration

We welcome collaboration! If you have ideas, suggestions, or would like to contribute to the project, feel free to reach out or submit a pull request. Together, we can enhance this plugin and make it even better! 🚀

---

🎉 Special Thanks

A big shoutout to the uCrop library for providing an excellent cropping experience on Android! Your contributions make this plugin even more powerful! 🙌