locality_social_cloud_calendar 1.0.0

A cloud calendar for Locality Social Cloud with support for finding time conflicts, heatmaps, to-do-items, parties, appointments and more.

locality_calendar

The Locality Calendar Library is a Flutter library designed to manage calendar events, tasks, and reminders in the Locality Social Cloud. With the CalendarSyndicate you can tap into existing content that is shared across all developers. It provides functionality for handling time-based chunks, detecting scheduling conflicts, and querying calendar items based on specific dates or time ranges. This library is ideal for applications that require robust calendar management, such as scheduling apps, task managers, or event planners.

Features

• Cloud-Synchronized Calendar: Easily synchronize calendars across all devices LIVE.
• Content-Syndication: Share your events with other developers and receive events from other developers with the CalendarSyndicate
• TimeChunk Management: Easily create and manage time chunks (start and end times) with methods to check for overlaps and containment.
• Conflict Detection: Automatically detect scheduling conflicts when adding new calendar items.
• Multi-Booked Time Detection: Identify time slots where multiple events overlap.
• Date Range Queries: Retrieve calendar items for specific days or within custom time ranges.
• Support for Multiple Calendar Item Types: Handle appointments, tasks, and reminders with customizable properties like importance and description.
• Heatmaps: Use Heatmaps to visualize how densely packed events are within a timeframe.

Main Classes

LocalitySocialCloudCalendar is your facade class to interact with. You can use

LocalitySocialCloudCalendar.getPersonalCalendarOfUser
LocalitySocialCloudCalendar.getPublicCalendarOfCity

to get a user Calendar. You can synchronize it with the cloud using

LocalitySocialCloud.supervise(YOUR_CALENDAR)

which will live-synchronize it with all observers. You can then add events, to-do-items, etc. with the methods the CloudCalendar gives you. With a SocialEvent you can also get public discussion and a list of attendees. Users can change their attendance status.

Setup

Obtain your app-ID and app secret from your developer account and write

LocalitySocialCloud.up(
    appId: "YOUR_APP_ID",
    appSecret: "YOUR_APP_SECRET",
    username: "USERNAME_OF_APP_USER",
    password: "PASSWORD_OF_APP_USER",
    onError: (AuthError error) {
      print(error.toString());
    },
  );

to set up your social cloud. You can also start the cloud in test mode with

LocalitySocialCloud.startInTestMode();

This will perform all actions locally and not synchronize events.

Usage