# Calendite

> Calendite is a calendar app that does what you want it to do. Instead of the outdated
> format most calendars use, it uses its own rule engine to say exactly how events repeat,
> worked out on your device. A preview build is available for Android now.

This file points AI agents at the Markdown sources for Calendite's documentation.
When both a `.md` and `.html` version of a page exist, prefer the `.md`.
The complete documentation in a single file: https://calendite.com/llms-full.txt

## Documentation

<!-- DOCS:START generated by build_docs.py from docs/*.md; do not edit by hand -->
- [Getting started](https://calendite.com/docs/getting-started.md): What happens the first time you open Calendite, how to find your way around, and how to create your first event.
- [How Calendite differs](https://calendite.com/docs/how-calendite-differs.md): The handful of places Calendite breaks with the standard calendar model, and what that lets you do.
- [Rule reference](https://calendite.com/docs/rules-reference.md): The full Calendite rule syntax, covering weekdays, nth-of-month, dates, shifts, Easter, and exclusions.
- [Troubleshooting](https://calendite.com/docs/troubleshooting.md): Fixes and explanations for the most common problems, including late alarms, failed pairing, notes that won't move and rules that produce no dates.

### Everyday use
The parts of Calendite you'll touch most: views, repeats, events within events, alerts, tags, notes and feeds.
- [Calendar views](https://calendite.com/docs/everyday-use/calendar-views.md): How Month, Week and Day views work, including the transposed week view where an event's width is its duration.
- [Calendar items](https://calendite.com/docs/everyday-use/calendar-items.md): The four kinds of thing you can put on a Calendite calendar — events, reminders, deadlines and time periods — and what each one does differently.
- [Building repeats](https://calendite.com/docs/everyday-use/building-repeats.md): How to build almost any repeating schedule with the pickers, without typing a rule.
- [Repeating events](https://calendite.com/docs/everyday-use/repeating-events.md): An introduction to Calendite's rule language and the handful of forms that cover almost everything you'll want to schedule.
- [Editing and deleting](https://calendite.com/docs/everyday-use/editing-and-deleting.md): Whether a change touches one occurrence or the whole series, and why removing a single date is always reversible.
- [Inner and variant events](https://calendite.com/docs/everyday-use/inner-and-variant-events.md): Two ideas other calendars don't have: events that only happen inside other events, and one event that wears several different shapes.
- [Reminders and alerts](https://calendite.com/docs/everyday-use/reminders-and-alerts.md): What alarms, notifications and reminders each do in Calendite, and how alert text is built.
- [Launching apps from alarms](https://calendite.com/docs/everyday-use/launching-apps-from-alarms.md): Attach an app to an alarm so the ringing screen shows that app's own icon and opens it with a single tap.
- [Tags, colours and filtering](https://calendite.com/docs/everyday-use/tags-colours-and-filtering.md): How tags colour your calendar, how filtering changes what you see, and how categories differ from tags.
- [Location and places](https://calendite.com/docs/everyday-use/location-and-places.md): Attaching a place to an event, including room and floor, and exactly what address search sends to the internet.
- [Notes and descriptions](https://calendite.com/docs/everyday-use/notes-and-descriptions.md): Calendite's notes are plain Markdown files in a folder you choose, so you can edit them from Obsidian or any other editor.
- [Data sources and feeds](https://calendite.com/docs/everyday-use/data-sources-and-feeds.md): Turn a JSON feed of dates (bank holidays, term dates, fixture lists) into a named category you can use in any recurrence rule.

### Guides
Practical, task-focused walkthroughs for getting real schedules into Calendite.
- [Shift planning](https://calendite.com/docs/guides/shift-planning.md): Turn a rotating shift pattern into a single Calendite event with variants.

### Privacy and sharing
How calendar sharing works without accounts or a cloud, and the complete list of what can ever leave your device.
- [Sharing your calendar](https://calendite.com/docs/privacy/sharing-your-calendar.md): Pair with someone in person, hide individual events, and see exactly what a sync server can and can't read.
- [What leaves your device](https://calendite.com/docs/privacy/what-leaves-your-device.md): The complete list of everything Calendite can send anywhere, when it sends it, and who receives it.
- [How the encryption works](https://calendite.com/docs/privacy/how-the-encryption-works.md): Two ciphers instead of one, hybrid post-quantum key agreement, and a pairing ceremony with no key server, plus what this protects against and what it doesn't.

### Reference
Precise lookups covering what the words mean, every alert template variable, and the lunar and Easter rules.
- [Glossary](https://calendite.com/docs/reference/glossary.md): What Calendite means by event series, inner and variant events, tags, alerts, visibility and the rest of its vocabulary.
- [Alert template syntax](https://calendite.com/docs/reference/alert-template-syntax.md): Every variable you can put in an alert title, from the event name to how long is left before it starts.
- [Moon rules](https://calendite.com/docs/reference/moon-rules.md): The full MOON() syntax for scheduling by lunar phase, illumination percentage or a range.
- [Easter rules](https://calendite.com/docs/reference/easter-rules.md): The full EASTER() syntax for Easter Sunday and the days that move with it, Western or Orthodox.
- [Checking a rule with Calendite's own validator](https://calendite.com/docs/reference/dsl-validator.md): The Python validator Calendite uses to check recurrence rules, embedded in full so an agent can run it and verify a rule it has written rather than guessing from the syntax documentation.
<!-- DOCS:END -->

## Site

- [Home](https://calendite.com/): Calendite marketing site and overview
- [Live demo](https://calendite.com/demo/): In-browser demo of the app