developer guide

cozy-calendar is a typical cozy app, with a server based on americano, and a client on backbonejs.

Server

The server is:

• a straightforward API for Event, Alarm and Contact doctypes,
• send mail to event's attendees,
• serialize and parse iCal.

Client

The client contains the main parts of the app's logic, and require some essential library:

• FullCalendar: display the calendar, and events on it,
• rrule.js: manipulate and generate instance for recurring rules.
• moment-timezone: datetime manipulation, with timezone.

RRule

RRule.js has limited support of timezone. It uses javascript Date object, so it use the computing environment timezone (see date-handling-in-javascript), which leads to hardly predictable time changes, due to DST. But they can be fixed.

rrule.js generate the date's instances of a recurring event, but may apply unappropriated time changes. This may create a shift of 1 hour, forward or backward. A check on the hour with moment-timezone, with the right date, time, and timezone allows to correct the shift.