Skip to content

algoo/open-calendar

Repository files navigation

Open Calendar

Open Calendar is a modern web calendar frontend for CalDAV based calendars.

Open Calendar

Key features

  • Configure individual calendars or multiple CalDAV servers
  • Display multiple calendars at the same time
  • Hide or show calendars and copy their URLs
  • Use the original calendar name and color
  • Show recurring events, alarms and attendees
  • Select timezones
  • Easily customize and integrate forms, notifications and rendering

There are 3 ways to use it

  1. With just a few lines of code, you can get a ready-to-use CalDAV client web application
  2. With a bit of development, you can integrate it into your web application by customizing the forms
  3. With a bit more work, you can even customize all components like event rendering, notifications, etc

Features

Supports multiple calendars at the same time

Open Calendar can deal with many CalDAV calendars at once, and also discover calendars directly from CalDAV servers.

Functional out of the box

Open Calendar supports all the features you would expect from a calendar client with little to no configuration: hide or show calendars or copy their URLs; drag, drop and resize events; show recurring events, alarms, attendees and more.

Easily customizable

Open Calendar is built to be customizable and integrated into larger apps. Events content, forms, dropdowns and even notifications can be replaced by custom ones with ease

Quick start

First, install Open Calendar with the package manager of your choice (yarn in this case):

yarn add open-dav-calendar

Once this is done, you can add Open Calendar to your application at different levels:

🚧 Bellow is a work in progress 🚧

Minimal setup

With just a few lines of code, you can get a ready-to-use CalDAV client web application. All you need to do install open-dav-calendar and tsdav (for auth functions) and call createCalendar:

import { createCalendar } from "open-dav-calendar";
// You can install `tsdav` to access a variety of auth functions (https://tsdav.vercel.app/docs/helpers/authHelpers)
import { getBasicAuthHeaders } from "tsdav";

const serverUrl = window.prompt("server url")
const username = window.prompt("username")
const password = window.prompt("password")
createCalendar(
    [{ serverUrl: serverUrl, headers: getBasicAuthHeaders({ username, password }) }],
    document.getElementById("open-calendar"),
)

Customized forms

With a bit of development, you can integrate it into your web application by customizing the forms

Complete integration

With a bit more work, you can even customize all components like event rendering, notifications, etc

Architecture & development

Open Calendar is a TypeScript application relying on 3 main components:

Need support, maintenance or features development?

Contact us at contact@algoo.fr

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •