Skip to content

nextcloud/calendar

Repository files navigation

Nextcloud Calendar

GitHub Workflow Status Codecov

A calendar app for Nextcloud. Easily sync events from various devices with your Nextcloud and edit them online.

๐Ÿ’™ ๐ŸŽ‰ Why is this so awesome?

  • ๐Ÿš€ Integration with other Nextcloud apps! Like Contacts, Talk, Tasks, Deck and Circles
  • ๐ŸŒ WebCal Support! Want to see your favorite team's matchdays in your calendar? No problem!
  • ๐Ÿ™‹ Attendees! Invite people to your events
  • โŒš Free/Busy! See when your attendees are available to meet
  • โฐ Reminders! Get alarms for events inside your browser and via email
  • ๐Ÿ” Search! Find your events at ease
  • โ˜‘๏ธ Tasks! See tasks or Deck cards with a due date directly in the calendar
  • ๐Ÿ”ˆ Talk rooms! Create an associated Talk room when booking a meeting with just one click
  • ๐Ÿ“† Appointment booking Send people a link so they can book an appointment with you using this app
  • ๐Ÿ™ˆ Weโ€™re not reinventing the wheel! Based on the great c-dav library, ical.js and fullcalendar libraries.

๐Ÿ› ๏ธ Installation

The app is distributed through the app store and you can install it right from your Nextcloud installation.

Release tarballs are hosted at https://github.com/nextcloud-releases/calendar/releases.

๐Ÿ“ก Support

If you need assistance or want to ask a question about Calendar, you are welcome to ask for support in our Forums. If you have found a bug, feel free to open a new Issue on GitHub. Keep in mind, that this repository only manages the frontend. If you find bugs or have problems with the CalDAV-Backend, you should ask the team at Nextcloud server for help!

๐ŸŒ Supported Browsers

  • Chrome/Chromium 76+
  • Edge 40+
  • Firefox 60+
  • Internet Explorer 11
  • Safari 12.1+

Maintainers

Build the app

To build you will need to have Node.js and Composer installed.

  • Install PHP dependencies: composer install
  • Install JS dependencies: npm ci
  • Build JavaScript for the frontend
    • npm run dev development build
    • npm run watch watch for changes
    • npm run build production build

Read more about necessary prerequisites for manual installs.

Running tests

You can run the following back-end and front-end tests by using:

composer test
npm run test

โœŒ๏ธ Code of conduct

The Nextcloud community has core values that are shared between all members during conferences, hackweeks and on all interactions in online platforms including Github and Forums. If you contribute, participate or interact with this community, please respect our shared values. ๐Ÿ˜Œ

โค๏ธ How to create a pull request

This guide will help you get started: