{"id":27114977,"url":"https://github.com/tanish-ranjan/crop-kit","last_synced_at":"2025-04-13T08:12:36.799Z","repository":{"id":286465555,"uuid":"961423808","full_name":"Tanish-Ranjan/crop-kit","owner":"Tanish-Ranjan","description":"Crop Kit is a Jetpack Compose library that allows you to easily crop images with customizable crop shapes such as Rectangle, Square, and Circle. It provides a simple yet flexible crop composable to seamlessly integrate into your Android applications. Features include image flipping, rotation, and gridlines to enhance the cropping experience.","archived":false,"fork":false,"pushed_at":"2025-04-08T21:24:39.000Z","size":1010,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-11T00:59:09.435Z","etag":null,"topics":["android","image-cropping","image-processing","jetpack-compose","kotlin","library","mobile-development","open-source"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Tanish-Ranjan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-04-06T13:49:58.000Z","updated_at":"2025-04-08T07:04:42.000Z","dependencies_parsed_at":"2025-04-09T22:34:27.587Z","dependency_job_id":null,"html_url":"https://github.com/Tanish-Ranjan/crop-kit","commit_stats":null,"previous_names":["tanish-ranjan/crop-kit"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tanish-Ranjan%2Fcrop-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tanish-Ranjan%2Fcrop-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tanish-Ranjan%2Fcrop-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tanish-Ranjan%2Fcrop-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tanish-Ranjan","download_url":"https://codeload.github.com/Tanish-Ranjan/crop-kit/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248322611,"owners_count":21084336,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","image-cropping","image-processing","jetpack-compose","kotlin","library","mobile-development","open-source"],"created_at":"2025-04-07T04:39:34.998Z","updated_at":"2025-04-11T00:59:15.957Z","avatar_url":"https://github.com/Tanish-Ranjan.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Crop Kit 🏜️\n\nCrop Kit is a Jetpack Compose library that allows you to easily crop images. It provides a simple\nyet customizable crop composable to style embed it in your app seamlessly.\n\n## ✨ Features\n\n- Provides three crop shapes: Rectangle, Square, and Circle.\n- Allows flipping the image vertically or horizontally.\n- Image can be rotated clockwise and anti-clockwise by 90 degrees.\n- Gridlines can be enabled or disabled.\n\n## Preview\n\nhttps://github.com/user-attachments/assets/df19cff9-95fe-415d-bf17-0a8bb4da7a32\n\n## 🚀 Getting Started\n\n1. **Add the JitPack repository to your root build.gradle file:**\n    \u003cdetails open\u003e\n    \u003csummary\u003eKotlin DSL\u003c/summary\u003e\n\n    ```gradle\n    dependencyResolutionManagement {\n        ...\n        repositories {\n            ...\n            maven { setUrl(\"https://jitpack.io\") }\n        }\n    }\n    ```\n\n    \u003c/details\u003e\n\n    \u003cdetails\u003e\n    \u003csummary\u003eGroovy DSL\u003c/summary\u003e\n\n    ```gradle\n    dependencyResolutionManagement {\n        ...\n        repositories {\n            ...\n            maven { url 'https://jitpack.io' }\n        }\n    }\n    ```\n\n    \u003c/details\u003e\n\n2. **Add the dependency:**\n    \u003cdetails open\u003e\n    \u003csummary\u003eKotlin DSL\u003c/summary\u003e\n\n    ```gradle\n    dependencies {\n        implementation(\"com.github.Tanish-Ranjan:crop-kit:version\")\n    }\n    ```\n\n    \u003c/details\u003e\n\n    \u003cdetails\u003e\n    \u003csummary\u003eGroovy DSL\u003c/summary\u003e\n\n    ```gradle\n    dependencies {\n        implementation 'com.github.Tanish-Ranjan:crop-kit:version'\n    }\n    ```\n\n    \u003c/details\u003e\n\n3. **Use the Composable:**\n    ```kotlin\n    @Composable\n    fun ColumnScope.CropComposable() {\n        // Create a crop controller and pass it your image bitmap\n        val cropController = rememberCropController(bitmap = mBitmap)\n   \n        // Pass the controller to the ImageCropper composable\n        ImageCropper(\n            modifier = Modifier\n                .fillMaxWidth()\n                .weight(1f)\n                .padding(24.dp),\n            cropController = cropController\n        )\n        \n        Button(\n            onClick = {\n                val croppedBitmap = cropController.crop()\n                // Handle the croppedBitmap\n            }\n        ) {\n            Text(\"Crop\")\n        }  \n    }\n    ```\n\nSee [demo app](/app) for full implementation.\n\n## 🤝 Contributing\n\nWe welcome contributions! Please read our [Contributing Guide](CONTRIBUTING.md) for more information\non how to get involved.\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftanish-ranjan%2Fcrop-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftanish-ranjan%2Fcrop-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftanish-ranjan%2Fcrop-kit/lists"}