Animated Calendar

Welcome to the Animated Calendar package! This modern and visually appealing calendar is designed for Flutter applications, featuring smooth animations and a stunning blue-and-white theme.

🌟 Features

  • 🎨 Stylish UI: Enjoy a sleek and modern blue-and-white theme.
  • πŸ“… Smooth Animations: Experience seamless date selection animations.
  • πŸ”„ Flexible Views: Effortlessly switch between month and week views.

πŸ“¦ Installation

To get started, add the package to your pubspec.yaml:

dependencies:
  animated_calendar: ^1.0.1

πŸš€ Getting Started

Here's a quick example to help you integrate the Animated Calendar into your Flutter app:

import 'package:animated_calendar/animated_calendar.dart';

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Animated Calendar Example'),
        ),
        body: Center(
          child: AnimatedCalendar(
            initialDate: DateTime.now(),
            onDateChanged: (date) {
              print('Selected date: $date');
            },
          ),
        ),
      ),
    );
  }
}

πŸ“– Advanced Usage

Customizing the Theme

You can easily customize the colors and styles of the calendar to fit your app's theme:

AnimatedCalendar(
  initialDate: DateTime.now(),
  theme: CalendarTheme(
    primaryColor: Colors.blue,
    secondaryColor: Colors.white,
    todayColor: Colors.orange,
    selectedDateColor: Colors.green,
    weekendTextColor: Colors.red,
  ),
  onDateChanged: (date) {
    print('Selected date: $date');
  },
)

Handling Date Selection

The onDateChanged callback provides the selected date, allowing you to handle date changes as needed:

AnimatedCalendar(
  initialDate: DateTime.now(),
  onDateChanged: (date) {
    // Perform any action with the selected date
    print('Selected date: $date');
  },
)

Switching Between Views

You can programmatically switch between month and week views using the viewMode parameter:

AnimatedCalendar(
  initialDate: DateTime.now(),
  viewMode: ViewMode.month, // or ViewMode.week
  onDateChanged: (date) {
    print('Selected date: $date');
  },
)

🎯 Best Practices

  • Ensure that the initialDate is set to the current date or a relevant date for your application.
  • Customize the theme to match your app's design for a consistent user experience.
  • Use the onDateChanged callback to handle date selection changes effectively.

πŸ› οΈ Contributing

We welcome contributions! If you'd like to contribute, please check out our contribution guidelines.

πŸ“„ License

This project is licensed under the MIT License. See the LICENSE file for more details.

πŸ’¬ Support

If you have any questions, feel free to open an issue or join our community chat.

πŸ“ž Contact

For more information or support, please contact the publisher:

Thank you for using Animated Calendar! We hope it brings life and elegance to your Flutter applications. Happy coding! πŸš€

Libraries

animated_calendar
Support for doing something awesome.