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

================
calendaring-sync
================

.. meta::
   :description: A Python library for calendar sync state: sync tokens, object versions, change tracking, and conflict detection.

A Python library for calendar sync state: sync tokens, object versions, change tracking, and conflict detection.

.. grid:: 2
    :gutter: 2

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

        Sync a calendar into a SQLite file.

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

        Connect a server, record edits, read changes, resolve conflicts, run in production.

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

        Every class and method, guarantees and limits, sync terms, and server behavior.

    .. grid-item-card:: 💡 Explanation
        :link: explanation/index
        :link-type: doc

        When to use calendaring-sync, and why it works the way it does.

    .. 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 the risks to know.

.. toctree::
   :hidden:

   tutorials/quickstart
   how-to/index
   Reference <reference/index>
   explanation/index
   contribute
   security
   release