.. SPDX-FileCopyrightText: 2026 calendaring-jmap contributors
.. SPDX-License-Identifier: AGPL-3.0-or-later

================
calendaring-jmap
================

Calendar operations over JMAP (:rfc:`8620` + draft-ietf-jmap-calendars).

.. grid:: 2
    :gutter: 2

    .. grid-item-card:: 🚀 Quickstart
        :link: tutorials/quickstart
        :link-type: doc

        List your calendars in a few lines.

    .. grid-item-card:: 📋 How-to guides
        :link: how-to/install
        :link-type: doc

        Install, authenticate, and work with events, sync, and tasks.

    .. grid-item-card:: 📖 Reference
        :link: reference/index
        :link-type: doc

        Every class and method, generated from the source.

    .. grid-item-card:: 💡 Design
        :link: explanation/design
        :link-type: doc

        Why the client is built the way it is.

    .. grid-item-card:: 🤝 Contribute
        :link: contribute
        :link-type: doc

        Set up a dev environment, run tests, submit a PR.

    .. grid-item-card:: 🔒 Security
        :link: security
        :link-type: doc

        Report a vulnerability, and known risks.

.. toctree::
   :hidden:
   :caption: Tutorials

   tutorials/quickstart

.. toctree::
   :hidden:
   :caption: How-to guides

   how-to/install
   how-to/authenticate
   how-to/calendars
   how-to/events
   how-to/sync
   how-to/tasks
   how-to/errors

.. toctree::
   :hidden:
   :caption: Reference

   reference/index
   reference/client
   reference/async_client
   reference/objects
   reference/errors
   reference/changelog

.. toctree::
   :hidden:
   :caption: Explanation

   explanation/design

.. toctree::
   :hidden:
   :caption: Project

   contribute
   security