zeba_academy_offline_cache 1.0.0

A lightweight and powerful offline caching solution for Flutter. Supports cache-first and network-first strategies with auto expiry, built for offline-first apps, e-commerce, and content platforms.

📦 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!