zeba_academy_local_calendar 0.0.1

Offline calendar for lessons, events, and reminders.

📦 zeba_academy_local_calendar

A lightweight, fully offline Flutter calendar package for managing lessons, events, and reminders — built with performance and simplicity in mind.

---

✨ Features

• 📅 Monthly & Weekly Calendar Views
• ✅ Mark dates as completed, pending, or important
• 💾 Fully offline using Hive (No internet required)
• ⚡ Fast and lightweight
• 🧩 Clean architecture (Controller + Service + Widgets)
• 🎯 Easy integration into any Flutter app

---

📸 Preview

Add screenshots here (Recommended for pub.dev score)

---

🚀 Getting Started

1. Add Dependency

dependencies:
  zeba_academy_local_calendar:
    path: ../zeba_academy_local_calendar

---

2. Initialize Hive

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await Hive.initFlutter();
  Hive.registerAdapter(CalendarEventAdapter());

  runApp(const MyApp());
}

---

3. Import Package

import 'package:zeba_academy_local_calendar/zeba_academy_local_calendar.dart';

---

4. Use Calendar Widget

ZebaCalendar()

---

🧩 Example

import 'package:flutter/material.dart';
import 'package:zeba_academy_local_calendar/zeba_academy_local_calendar.dart';

class MyHomePage extends StatelessWidget {
  const MyHomePage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Local Calendar')),
      body: const ZebaCalendar(),
    );
  }
}

---

⚙️ Configuration

Option	Type	Default	Description
showWeekView	bool	false	Toggle between month and week view

---

📁 Architecture

lib/
 ├── src/
 │   ├── models/
 │   ├── services/
 │   ├── controllers/
 │   └── widgets/

---

🧪 Testing

Run tests using:

flutter test

---

📌 Roadmap

• ❌ Add long-press status selector
• ❌ Add notes UI
• ❌ Add animations
• ❌ Add theme customization
• ❌ Event list view

---

📄 License

GNU GENERAL PUBLIC LICENSE

Version 3, 29 June 2007

Copyright (C) 2026 Sufyan bin Uzayr

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

---

👨‍💻 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 https://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: https://zeba.academy ➡ Explore hands-on courses: https://code.zeba.academy ➡ YouTube: https://www.youtube.com/@zeba.academy ➡ Instagram: https://www.instagram.com/zeba.academy/

---

❤️ Support

If you like this package, consider giving it a ⭐ on GitHub and sharing it with the community!

---

Thank you for visiting! 🙌