{"id":14956381,"url":"https://github.com/nixrajput/cloudinary-dart","last_synced_at":"2025-10-24T09:30:39.263Z","repository":{"id":61975450,"uuid":"527229353","full_name":"nixrajput/cloudinary-dart","owner":"nixrajput","description":"A dart package to integrate Cloudinary API in Dart and Flutter.","archived":false,"fork":false,"pushed_at":"2023-10-18T13:46:15.000Z","size":399,"stargazers_count":8,"open_issues_count":1,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-29T09:35:47.215Z","etag":null,"topics":["cloudinary","cloudinary-api","cloudinary-sdk","flutter","flutter-packages","nixlab-packages","nixrajput","nixrajput-github","packages"],"latest_commit_sha":null,"homepage":"https://pub.dev/packages/cloudinary","language":"Dart","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/nixrajput.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","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},"funding":{"github":"nixrajput"}},"created_at":"2022-08-21T14:24:54.000Z","updated_at":"2024-08-05T11:53:31.000Z","dependencies_parsed_at":"2023-02-09T07:15:26.330Z","dependency_job_id":"cd070043-7f4c-4c6f-b2b6-09d9e00108ca","html_url":"https://github.com/nixrajput/cloudinary-dart","commit_stats":{"total_commits":17,"total_committers":3,"mean_commits":5.666666666666667,"dds":0.2941176470588235,"last_synced_commit":"362b33c4154c2fe8efbd2935155c340064c44572"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nixrajput%2Fcloudinary-dart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nixrajput%2Fcloudinary-dart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nixrajput%2Fcloudinary-dart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nixrajput%2Fcloudinary-dart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nixrajput","download_url":"https://codeload.github.com/nixrajput/cloudinary-dart/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237944095,"owners_count":19391588,"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":["cloudinary","cloudinary-api","cloudinary-sdk","flutter","flutter-packages","nixlab-packages","nixrajput","nixrajput-github","packages"],"created_at":"2024-09-24T13:12:56.554Z","updated_at":"2025-10-24T09:30:38.823Z","avatar_url":"https://github.com/nixrajput.png","language":"Dart","funding_links":["https://github.com/sponsors/nixrajput"],"categories":[],"sub_categories":[],"readme":"# cloudinary\n\nA dart package for to integrate [Cloudinary](https://cloudinary.com/) API into your dart and flutter app. This package is a wrapper around the [Cloudinary API](https://cloudinary.com/documentation/image_upload_api_reference).\n\n[![pub package](https://img.shields.io/pub/v/cloudinary.svg?label=Version)][pub]\n[![Stars](https://img.shields.io/github/stars/nixrajput/cloudinary-dart?label=Stars)][repo]\n[![Forks](https://img.shields.io/github/forks/nixrajput/cloudinary-dart?label=Forks)][repo]\n[![Watchers](https://img.shields.io/github/watchers/nixrajput/cloudinary-dart?label=Watchers)][repo]\n[![Contributors](https://img.shields.io/github/contributors/nixrajput/cloudinary-dart?label=Contributors)][repo]\n\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/nixrajput/cloudinary-dart?label=Latest)][releases]\n[![GitHub last commit](https://img.shields.io/github/last-commit/nixrajput/cloudinary-dart?label=Last+Commit)][repo]\n[![GitHub issues](https://img.shields.io/github/issues/nixrajput/cloudinary-dart?label=Issues)][issues]\n[![GitHub pull requests](https://img.shields.io/github/issues-pr/nixrajput/cloudinary-dart?label=Pull+Requests)][pulls]\n[![GitHub Licence](https://img.shields.io/github/license/nixrajput/cloudinary-dart?label=Licence)][license]\n\n## Table of Contents\n\n- [cloudinary](#cloudinary)\n  - [Table of Contents](#table-of-contents)\n  - [Installation](#installation)\n  - [Usage](#usage)\n    - [Initialize a Cloudinary object](#initialize-a-cloudinary-object)\n    - [Do a signed file upload](#do-a-signed-file-upload)\n    - [Do a unsigned file upload](#do-a-unsigned-file-upload)\n    - [Do a file delete *(this will use the cloudinary destroy method)*](#do-a-file-delete-this-will-use-the-cloudinary-destroy-method)\n  - [About Cloudinary](#about-cloudinary)\n  - [Contributing](#contributing)\n  - [License](#license)\n  - [Sponsor Me](#sponsor-me)\n  - [Connect With Me](#connect-with-me)\n  - [Activities](#activities)\n\n## Installation\n\nAdd `cloudinary` as a dependency in your `pubspec.yaml` file:\n\n```yaml\ndependencies:\n  cloudinary: ^latest_version\n```\n\nFinally you just have to run: `dart pub get` **or** `flutter pub get` depending on the project type and this will download the dependency to your pub-cache.\n\nAnd import it:\n\n```dart\nimport 'package:cloudinary/cloudinary.dart';\n```\n\n## Usage\n\n### Initialize a Cloudinary object\n\n```dart\n/// This three params can be obtained directly from your Cloudinary account Dashboard.\n/// The .signedConfig(...) factory constructor is recommended only for server side apps, \n/// where [apiKey] and [apiSecret] are secure. \nfinal cloudinary = Cloudinary.signedConfig(\n  apiKey: apiKey,\n  apiSecret: apiSecret,\n  cloudName: cloudName,\n);\n```\n\nor\n\n```dart\n/// The .unsignedConfig(...) factory constructor is recommended for client side apps, where [apiKey] and \n/// [apiSecret] must not be used, so .basic(...) constructor allows to do later unsigned requests.\nfinal cloudinary = Cloudinary.unsignedConfig(\n  cloudName: cloudName,\n);\n```\n\n### Do a signed file upload\n\nRecommended only for server side apps.\n\n```dart\nfinal response = await cloudinary.upload(\n  file: file.path,\n  fileBytes: file.readAsBytesSync(),\n  resourceType: CloudinaryResourceType.image,\n  folder: cloudinaryCustomFolder,\n  fileName: 'some-name',\n  progressCallback: (count, total) {\n    print('Uploading image from file with progress: $count/$total');\n  },\n);\n\nif (response.isSuccessful) {\n  print('Get your image from with ${response.secureUrl}');\n}   \n```\n\nYou can upload a file from path or byte array representation, you can also pass an `optParams` map to do a more elaborated upload according to \u003chttps://cloudinary.com/documentation/image_upload_api_reference\u003e. The `cloudinary.upload(...)` function is fully documented, you can check the description to know what other options you have.\n\n### Do a unsigned file upload\n\nRecommended for server client side apps. The way to do this request is almost the same as above, the only difference is the `uploadPreset` which is required for unsigned uploads.\n\n```dart\n\nfinal response = await cloudinary.unsignedUpload(\n  file: file.path,\n  uploadPreset: somePreset,\n  fileBytes: file.readAsBytesSync(),\n  resourceType: CloudinaryResourceType.image,\n  folder: cloudinaryCustomFolder,\n  fileName: 'some-name',\n  progressCallback: (count, total) {\n    print('Uploading image from file with progress: $count/$total');\n  }\n);\n\nif (response.isSuccessful) {\n  print('Get your image from with ${response.secureUrl}');\n}\n```\n\nYou can upload a file from path or byte array representation, you can also pass an `optParams` map to do a more elaborated upload according to \u003chttps://cloudinary.com/documentation/image_upload_api_reference\u003e. The `cloudinary.unsignedUpload(...)` function is fully documented, you can check the description to know what other options you have.\n\n### Do a file delete *(this will use the cloudinary destroy method)*\n\n```dart\nfinal response = await cloudinary.destroy(\n  'public_id',\n  url: url,\n  resourceType: CloudinaryResourceType.image,\n  invalidate: false,\n);\n\nif (response.isSuccessful ?? false){\n  //Do something else\n}\n```\n\nTo delete a cloudinary file it´s necessary a `public_id`, as you can see in the sample code the `deleteResource(...)` function can delete a file by it's url. You can also pass an `optParams` map to do a more elaborated delete *(destroy)* according to \u003chttps://cloudinary.com/documentation/image_upload_api_reference#destroy_method\u003e. The `cloudinary.destroy(...)` function is fully documented, you can check the description to know what other options you have.\n\n## About Cloudinary\n\nCloudinary is a powerful media API for websites and mobile apps alike, Cloudinary enables developers to efficiently manage, transform, optimize, and deliver images and videos through multiple CDNs. Ultimately, viewers enjoy responsive and personalized visual-media experiences—irrespective of the viewing device.\n\n## Contributing\n\nIf you would like to contribute to this project, feel free to fork the repository, make your changes, and submit a pull request. Please follow the guidelines in the [CONTRIBUTING.md](CONTRIBUTING.md) file.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Sponsor Me\n\n- By sponsoring my efforts, you're not merely contributing to the development of my projects; you're investing in its growth and sustainability.\n- Your support empowers me to dedicate more time and resources to improving the project's features, addressing issues, and ensuring its continued relevance in the rapidly evolving landscape of technology.\n- Your sponsorship directly fuels innovation, fosters a vibrant community, and helps maintain the project's high standards of quality. Together, we can shape the future of the projects and make a lasting impact in the open-source community.\n- Thank you for considering sponsoring my work!\n\n[![Sponsor](https://img.shields.io/static/v1?label=Sponsor\u0026message=%E2%9D%A4\u0026logo=GitHub\u0026color=%23fe8e86)](https://github.com/sponsors/nixrajput)\n\n## Connect With Me\n\n[![GitHub: nixrajput](https://img.shields.io/badge/nixrajput-EFF7F6?logo=GitHub\u0026logoColor=333\u0026link=https://www.github.com/nixrajput)][github]\n[![Linkedin: nixrajput](https://img.shields.io/badge/nixrajput-EFF7F6?logo=LinkedIn\u0026logoColor=blue\u0026link=https://www.linkedin.com/in/nixrajput)][linkedin]\n[![Instagram: nixrajput](https://img.shields.io/badge/nixrajput-EFF7F6?logo=Instagram\u0026link=https://www.instagram.com/nixrajput)][instagram]\n[![Twitter: nixrajput07](https://img.shields.io/badge/nixrajput-EFF7F6?logo=X\u0026logoColor=333\u0026link=https://x.com/nixrajput)][twitter]\n[![Telegram: nixrajput](https://img.shields.io/badge/nixrajput-EFF7F6?logo=Telegram\u0026link=https://telegram.me/nixrajput)][telegram]\n[![Gmail: nkr.nikhi.nkr@gmail.com](https://img.shields.io/badge/nkr.nikhil.nkr@gmail.com-EFF7F6?logo=Gmail\u0026link=mailto:nkr.nikhil.nkr@gmail.com)][gmail]\n\n## Activities\n\n![Alt](https://repobeats.axiom.co/api/embed/4b8f4a901f0f01f16cb60ed04cd43079ec9438f4.svg \"Repobeats analytics image\")\n\n[pub]: https://pub.dev/packages/cloudinary\n[github]: https://github.com/nixrajput\n[telegram]: https://telegram.me/nixrajput\n[twitter]: https://twitter.com/nixrajput07\n[instagram]: https://instagram.com/nixrajput\n[linkedin]: https://linkedin.com/in/nixrajput\n[gmail]: mailto:nkr.nikhil.nkr@gmail.com\n[releases]: https://github.com/nixrajput/cloudinary-dart/releases\n[repo]: https://github.com/nixrajput/cloudinary-dart\n[issues]: https://github.com/nixrajput/cloudinary-dart/issues\n[license]: https://github.com/nixrajput/cloudinary-dart/blob/master/LICENSE\n[pulls]: https://github.com/nixrajput/cloudinary-dart/pulls\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnixrajput%2Fcloudinary-dart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnixrajput%2Fcloudinary-dart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnixrajput%2Fcloudinary-dart/lists"}