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

Libraries

zeba_academy_local_calendar