pastilhasandClaude Opus 5 25c8502c4b create an event, newest day first, and a URL you can read
three small things, one of which turned out to be a bug in what shipped an hour
ago.

CREATE. a POST to /_officer/event, and the SIDECAR builds the file — the browser
sends title, when and where. a UID, a DTSTAMP and a UTC timestamp each have
exactly one correct form, and that belongs next to the parser that reads them
back, not in a react component. it writes the minimum a VEVENT can legally be:
no recurrence, no alarms, no attendees. this app cannot show those, and a field
the list cannot display is a field that silently disappears on the next edit.

times go in as UTC. the alternative is DTSTART;TZID plus a VTIMEZONE block
defining that zone's rules, and a subtly wrong VTIMEZONE moves an event by an
hour twice a year. UTC needs no definition and every client renders it local.
all-day is the other trap: RFC 5545 makes DTEND EXCLUSIVE, so a one-day event on
the 29th ends on the 30th — write the 29th and some clients draw nothing at all.
the form takes the last day a person means and the builder adds the day.

NEWEST DAY ON TOP. a calendar accumulates years, so ascending opened on whatever
was imported first and this week was a scroll away. within a day the order stays
chronological, because that is what a day is.

?collection=ra-guide, NOT ?collection=%2Fdav%2F1%2Fra-guide%2F. the path is
/dav/<userId>/<name>/, so the escaped form spent six characters on slashes to
say `ra-guide` and put the owner's user id in a URL people paste at each other.
the name is unique within a user, which is all a selector needs, and the full
path is recovered from the collections list the screen already loaded. a full
path in the param still resolves, because somebody's bookmark has one.

AND THE BUG. setProperty replaced a property's first line and left its
continuation lines behind. a value over 75 octets is FOLDED onto lines starting
with a space — so editing a long summary left the old tail folded onto the new
value, and each edit inherited the last one's ending. it only bites on long
values, which is why the first round of testing missed it. the fix consumes the
whole folded run and folds what it writes; both are now under test, including
the accent-near-the-boundary case that a naive slice(0,75) cuts in half.

verified live: both event shapes written and read back, escaping round-tripped,
and a long summary edited twice with no accumulation.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Officer-Session: 656f5c85-e49a-4f1f-b9f3-042a04b4d043
2026-08-27 10:40:10 +00:00
2026-08-27 07:36:16 +00:00

Calendar

Calendars and contacts on your own machine, synced to your phone over CalDAV and CardDAV.

  • Radicale, not a container. A ~2MB Python package, spawned on loopback by this plugin's sidecar. It was a Docker service only because the old app store made everything one.
  • Per user. The sync door resolves an app password to one account and tells Radicale that account's id is the principal; [rights] type = owner_only does the rest. Every user gets their own calendars and their own contacts, in their own directory, invisible to everyone else.
  • Phones work. DAVx5, iOS and Thunderbird, including RFC 6764 autodiscovery from a bare domain.

Two screens, one plugin

/calendar and /contacts. They are two places you go rather than two sections of one page, which is why this is the first plugin to declare screens in its manifest — one sidecar, one permission, one install, two routes and two dock tiles.

What it claims from the platform, and why

Four paths outside /api, above the account gate:

Path Why it cannot sit behind the session
/dav/* DAVx5, iOS and Thunderbird send HTTP Basic on every request and have nowhere to put a JWT
/dav/provision/*.mobileconfig Safari is handed a URL by the phone app and has no credential; the one-shot token in the path IS the authentication
/.well-known/caldav RFC 6764 — probed with a bare domain before the client has any credential
/.well-known/carddav the same, for contacts

"Above the account gate" is not "open". The sync door demands a scoped DAV app password and resolves it to a user before anything reaches Radicale.

Every one of those is in the platform's RESERVED_ROOT, claimable only by a first-party plugin. A third-party plugin is confined to /p/<publisher>/ so it can never shadow a core route.

Extracted from the platform on 2026-08-27

It was core from 2026-08-19. What moved: the sidecar, the four routers, the panel apps, the app-password table, and the settings form — which became a modal on the Calendar screen, because a plugin ships panels and cannot contribute a settings section.

Two things deliberately did not change. The table is still dav_app_passwords rather than caldav_app_passwords: installs already hold real rows, and the platform's prefix convention is not worth a data migration on a live machine. And the panel names still resolve through the platform's translation catalogs, so the six locales they had as core screens survive.

S
Description
Calendars and contacts on your own machine, synced to your phone over CalDAV and CardDAV.
Readme
777 KiB
Languages
TypeScript 100%