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 #

📁 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

3. Commit changes

git commit -m "Add new feature"

4. Push

git push origin feature/new-feature

5. 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 ❤️