📦 zeba_academy_offline_cache

A lightweight, powerful, and flexible offline caching solution for Flutter apps.

Designed for offline-first applications, this package enables seamless data access even without internet connectivity.

✨ Features

⚡ Cache network requests for offline use
🔄 Auto expiry & refresh mechanism
🎯 Multiple cache policies (cache-first, network-first, etc.)
🧩 Supports JSON, images, and extendable for videos
🪶 Lightweight storage using Hive
🚀 Simple and clean API

📦 Installation

Add this to your pubspec.yaml:

dependencies:
  zeba_academy_offline_cache: ^1.0.0

🚀 Getting Started

1. Initialize Storage

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await StorageService.init();
  runApp(MyApp());
}

2. Fetch Data with Cache

final data = await CacheManager.fetch(
  url: "https://jsonplaceholder.typicode.com/posts",
  policy: CachePolicy.cacheFirst,
  expiry: Duration(minutes: 10),
);

🎯 Cache Policies

Policy	Description
cacheFirst	Uses cache first, falls back to network
networkFirst	Uses network first, falls back to cache
cacheOnly	Only returns cached data
networkOnly	Always fetches from network

📦 Example

final result = await CacheManager.fetch(
  url: "https://api.example.com/data",
  policy: CachePolicy.networkFirst,
);

print(result);

🧠 Use Cases

📱 Offline-first mobile apps
🛒 E-commerce apps
📰 Content/news apps
📚 Learning platforms

⚙️ Advanced Usage

Custom Expiry

await CacheManager.fetch(
  url: "https://api.example.com/data",
  expiry: Duration(hours: 1),
);

Clear Cache

await StorageService.clear();

🛠️ Roadmap

🔄 Background sync
📡 Connectivity-aware caching
🖼️ Advanced image & video caching
🔐 Secure storage (encryption)

🤝 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

📄 License

This project is licensed under the GPL License.

👨‍💻 About Me

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects. You can learn more about me and my work at sufyanism.com or connect with me on Linkedin

🌐 Your all-in-one no-bloat hub!

🚀 Explore cutting-edge resources in coding, tech, and development at zeba.academy and code.zeba.academy. Empower yourself with practical skills through curated directives, real-world projects, and hands-on experience. Level up your tech game today! 💻✨

Zeba Academy is a learning platform dedicated to coding, technology, and development. ➡ Visit our main site: zeba.academy ➡ Explore hands-on courses and resources at: code.zeba.academy ➡ Check out our YouTube for more tutorials: zeba.academy ➡ Follow us on Instagram: zeba.academy

Thank you for visiting!