Zeba Academy Image Tools

A Flutter image utilities package for building beautiful image experiences.

✨ About

Zeba Academy Image Tools is a Flutter package that provides reusable image utility widgets.

It helps developers easily add modern image features into Flutter applications.

Features Included

  • Image preview widgets
  • Zoom image viewer
  • Crop UI
  • Image placeholders
  • Loading states
  • Error handling

🚀 Features

🖼️ Image Preview

Display network images with a clean UI.

Features:

  • Rounded corners
  • Custom width and height
  • BoxFit support
  • Loading indicator
  • Error fallback

Example:

ZebaImagePreview(
  imageUrl: "https://picsum.photos/500",
)

🔍 Zoom Viewer

Interactive full-screen image viewer.

Features:

  • Pinch zoom
  • Double tap zoom
  • Smooth image navigation

Example:

Navigator.push(
 context,
 MaterialPageRoute(
  builder: (_) =>
  ZebaImageZoomViewer(
   imageUrl:
   "https://picsum.photos/500",
  ),
 ),
);

✂️ Crop UI

Crop images easily inside Flutter apps.

Features:

  • Android support
  • iOS support
  • Custom crop screen

Example:

ZebaImageCropView(
 image: file,
)

🖼️ Placeholder Widget

Show beautiful placeholders when an image is missing.

Example:

ZebaImagePlaceholder()

📦 Installation

Add dependency:

dependencies:

  zeba_academy_image_tools:
    latest

Run:

flutter pub get

⚡ Usage

Import:

import 'package:zeba_academy_image_tools/
zeba_academy_image_tools.dart';

Example:

Column(

 children: [

  ZebaImagePreview(
   imageUrl:
   "https://picsum.photos/500",
  ),


  ZebaImagePlaceholder(),


 ]

)

🛠️ Requirements

Requirement Version
Flutter >=3.0.0
Dart >=3.0.0

📁 Package Structure

zeba_academy_image_tools

lib
 ├── zeba_academy_image_tools.dart
 │
 └── src
      ├── image_preview.dart
      ├── image_zoom_viewer.dart
      ├── image_crop_view.dart
      ├── image_placeholder.dart
      └── image_tools.dart


test
 └── image_tools_test.dart

🧪 Testing

Run:

flutter test

🤝 Contributing

Contributions are welcome.

Steps:

  1. Fork repository

  2. Create branch

git checkout -b feature/new-feature
  1. Commit changes
git commit -m "Add new feature"
  1. Push
git push origin feature/new-feature
  1. Create Pull Request

🐛 Bug Reports

If you find an issue, please include:

  • Flutter version
  • Device information
  • Error details
  • Steps to reproduce

👨‍💻 About Me

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects.

Learn more:

https://sufyanism.com/

LinkedIn:

https://www.linkedin.com/in/sufyanism

🎓 Zeba Academy

Your all-in-one learning hub!

🚀 Learn:

  • Coding
  • Technology
  • Development
  • Real-world projects

Main Website:

https://zeba.academy

Courses:

https://code.zeba.academy

YouTube:

https://www.youtube.com/@zeba.academy

Instagram:

https://www.instagram.com/zeba.academy/

📜 License

This project is licensed under the GNU General Public License v3.0.

You are free to:

✔ Use the package ✔ Modify the source code ✔ Share improvements ✔ Distribute copies

Under GPL-3.0 conditions.

See:

LICENSE

⭐ Support

If this package helps you:

⭐ Star the repository

🐛 Report issues

🤝 Contribute improvements

Thank you for using Zeba Academy Image Tools ❤️

Libraries

zeba_academy_image_tools