# Calendula — Current State *Last updated: 2026-06-17* ## Status **Milestone:** 2 (write support) **complete** — v2.0.0 shipped 2026-06-11; v2.1.0 (month event grid, drawer view tabs, cursor fix) shipped 2026-06-15. **Phase:** post-2.1 backlog work. v2.2.0 (tap-to-create in day/week + local calendar management) and v2.3.0 (Material 3 grouped-list redesign of Settings, the calendar manager and the navigation drawer) both shipped 2026-06-16; v2.4.0 (per-event colors) and v2.5.0 (jump-to-date, Agenda view, home-screen agenda + month widgets, and a "New event" launcher shortcut) shipped 2026-06-17. The backlog is now organised by theme in `ROADMAP.md`. ## Progress - [x] Design spec written and committed (`docs/superpowers/specs/2026-06-08-calendar-app-design.md`) - [x] V1 design decisions resolved (App name "Calendula", icon, seed color) - [x] Plan 01 written and executed — foundation lands (theme, icon, i18n, Hilt, DataStore, CI green) - [x] Plan 02 written and executed — data layer + permission flow + debug screen - [x] Month view (S1) — 6-week grid, event dots, today marker, swipe nav, three states (replaces debug screen) - [x] Week view (S2) — time schedule with overlap-resolved lanes, all-day strip, swipe nav, three states - [x] Day view (S3) — single-column slice reusing the week layout - [x] View-switcher (M1) wired — cycles Month ↔ Week ↔ Day - [x] Event-detail screen (S4) — full-screen, humanized recurrence - [x] Filter sheet (M3) — per-calendar visibility, grouped by account, persisted, applied centrally in the repository - [x] Settings (M4) — appearance (theme, dynamic colour, week start), language (per-app locales), about - [~] Jump-to-date (M2) — **cut from scope**; "Today" half shipped in v0.5, date-picker dropped - [x] Full event read (v0.6) — reminders, status, availability, access level, attendee role + self-response, foreign timezone, and linkified description URLs in the detail view; new domain enums + mapper unit tests. (A dedicated URL field was cut — no `CalendarContract` column backs it.) - [x] v1.1 write foundation — `WRITE_CALENDAR` (onboarding asks READ+WRITE, only READ gates; contextual upgrade for v1.0 installs), read-only-calendar detection (`CALENDAR_ACCESS_LEVEL` → `canModifyContents`, actions hidden for WebCal/birthday calendars), delete from the detail screen (recurring: "only this event" via cancelled exception / "all events in the series"), repository + mapper tests - [x] v1.2 create event — full-screen `EventEditScreen` (title, all-day, M3 date/time pickers with duration-preserving start moves, writable-only calendar picker preselecting the last-used calendar, location, description), "+" FAB on all three views prefilled with the visible day, `insertEvent` with provider-correct all-day normalisation (UTC midnights, exclusive end), domain/mapper/repository tests - [x] v1.3 edit event (shipped 2026-06-11) — `EventEditScreen` reused for edit (detail-screen Edit action, `canModify`-gated, contextual WRITE upgrade), dirty-checked partial `update` on the Events row (recurring: series DTSTART moves by the user's delta, DURATION instead of DTEND), reminder diff by minutes (kept rows keep their method), simple recurrence picker (FREQ/INTERVAL/UNTIL/COUNT; complex RRULEs preserved verbatim and shown humanized), `EventFormField.Recurrence` incl. settings default, recurrence also available on create; domain/mapper/repository tests. Review round 1: weekly BYDAY day-toggles in the custom picker ("every week on Mon+Fri"). Review rounds 2–4: occurrence edit pulled forward from v2.0 and made three-way like delete ("this" = exception row via `CONTENT_EXCEPTION_URI`, "this and following" = series split, "all" = series update); delete equally three-way (truncation via RRULE UNTIL); the edit-scope question moved to save time (Google model) — dirty recurring saves park in `SaveUiState.AwaitingScope`, a changed rule drops the "only this event" option - [x] v1.4 reminder notifications (shipped 2026-06-11) — exported `EVENT_REMINDER` receiver → `CalendarAlerts` (SCHEDULED & due) → dedicated channel, tap opens detail (singleTop deep link); best-effort FIRED marking; one-time onboarding step requesting `POST_NOTIFICATIONS` with duplicate-reminders warning; Settings mirror. Provider only fires `METHOD_ALERT` rows (AOSP-verified), so email reminders never reach us - [x] v2.0 conflict dialog + store polish (shipped 2026-06-11 as v2.0.0) — `EditSnapshot` compare on save (overwrite/discard; deleted → close), quick-add cut, calendar-switch → v3 backlog; F-Droid/README copy refreshed, fastlane screenshots DE+EN captured on-device - [x] v2.1 (shipped 2026-06-15) — month grid shows real events as continuous multi-day bars; navigation-drawer View section (Month/Week/Day); cursor-jump fix in event text fields - [x] v2.2 (shipped 2026-06-16) — tap an empty slot in day/week to create (prefilled with that day + tapped hour, snapped to the hour); local calendar management in a full-screen editor from Settings → Calendars: create/rename/recolor/delete device-only calendars (`ACCOUNT_TYPE_LOCAL`, sync-adapter insert) with name, pastel-previewed colour, and description (stored in `CAL_SYNC1`); synced calendars listed read-only grouped by account with a per-account "manage in source app" deep-link (resolved from the account's authenticator: DAVx5/ICSx5/…) and an add-account shortcut. Shared `InlineTextField` extracted to `ui.common` - [x] v2.3 settings/calendars/drawer redesign (shipped 2026-06-16) — adopted a shared Material 3 grouped-list blueprint, modelled on the ReFra gallery app and extracted to `ui/common/GroupedList.kt` (`CollapsingScaffold` with a `LargeTopAppBar` exit-until-collapsed title; `GroupedRow` with Position-based corner grouping, press-animated corners, `selected` + `minHeight` knobs). - Settings: category hub (About card on top → version mark at the foot) with sliding sub-pages (Appearance / New event form / Notifications); token- based icon chips; theme/week-start/language pickers migrated from `DropdownMenu` to OptionCard dialogs. New `ic_gitea.xml` (Simple Icons, verbatim path) for the About "Source" button; en+de strings. - Calendar manager: same collapsing scaffold + grouped rows; shared `CalendarColorChip` (neutral chip, pastelised calendar glyph). - Navigation drawer: branded header, grouped View switcher (active view highlighted via `secondaryContainer`), the filter list restyled to grouped rows with a trailing checkbox; the whole drawer scrolls as one. - Cards use `surfaceContainerHigh` for readable contrast against `surface`. - Donate button on the About card deferred (target still TBD). - [x] v2.4 per-event color (shipped 2026-06-17) — an optional "Color" field in the event form. Read/render already resolved `EVENT_COLOR` with a calendar fallback; this adds the write side and the picker. Palette-backed calendars (Google, some CalDAV) pick from the account's `Colors` (`TYPE_EVENT`) and write `EVENT_COLOR_KEY` so the color round-trips through sync; local calendars write a raw `EVENT_COLOR` from the shared `CALENDAR_COLOR_PALETTE` (extracted with the swatch row to `ui/common/ColorSwatchRow.kt`). Switching calendars resets the choice (a key is account-scoped). A settings toggle ("Allow colors on unsupported calendars", off by default) extends the raw path to synced calendars with no palette, with an honest "may not survive sync" warning on the picker and in Settings. Color writes flow through insert / dirty-checked update / occurrence-exception; mapper + form tests. ## Next 1. Monitor the F-Droid build/publish for the v2.4.0 tag 2. Decide the "Locations & People" and "remote calendar create/edit" go/no-go calls (both hinge on the INTERNET permission) — see `ROADMAP.md` 3. **Duplicate event** and **jump-to-date** are the cheap follow-ups; then agenda view (strategic, backs a future widget). Full ranked sequence in `ROADMAP.md` → "Near-term sequence".