calendula/.planning/STATE.md

Calendula — Current State

Last updated: 2026-06-22

Status

Milestone: 2 (write support) complete — v2.0.0 shipped 2026-06-11. Phase: post-2.x theme-based backlog work (organised in ROADMAP.md). Latest released tag: v2.7.5. The whole Tier 4 (reliability/data-safety/ interop) arc is now done or in flight:

• v2.4.0 per-event colors (2026-06-17)
• v2.5.0 jump-to-date, Agenda view, agenda + month home-screen widgets, "New event" launcher shortcut (2026-06-17)
• v2.6.0 default reminders (global + per-calendar override, all-day default, battery-exemption row) + system per-app language (2026-06-18)
• v2.7.0 .ics engine — single-event share, local-calendar backup export, open/receive .ics (single → form, many → bulk import, dedup by UID) (2026-06-18)
• v2.7.1–v2.7.5 — crash-reporting + F-Droid reproducible-build hardening + fixes

Next release release/v2.8.0 (integration branch, not yet cut to main): holds crash reports via the public Codeberg tracker (MR !27) + reminder snooze/dismiss notification actions (MR !28). Version bump to 2.8.0 happens at release-cut.

Progress

• Design spec written and committed (docs/superpowers/specs/2026-06-08-calendar-app-design.md)

• V1 design decisions resolved (App name "Calendula", icon, seed color)

• Plan 01 written and executed — foundation lands (theme, icon, i18n, Hilt, DataStore, CI green)

• Plan 02 written and executed — data layer + permission flow + debug screen

• Month view (S1) — 6-week grid, event dots, today marker, swipe nav, three states (replaces debug screen)

• Week view (S2) — time schedule with overlap-resolved lanes, all-day strip, swipe nav, three states

• Day view (S3) — single-column slice reusing the week layout

• View-switcher (M1) wired — cycles Month ↔ Week ↔ Day

• Event-detail screen (S4) — full-screen, humanized recurrence

• Filter sheet (M3) — per-calendar visibility, grouped by account, persisted, applied centrally in the repository

• 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

• 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.)

• 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

• 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

• 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

• 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

• 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

• 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

• 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

• 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).

• 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.

• v2.5 (shipped 2026-06-17) — Agenda view (4th top-level view), jump-to-date drawer date picker, two home-screen widgets (scrolling "Upcoming" agenda + month grid), and a "New event" launcher long-press shortcut

• v2.6 (shipped 2026-06-18) — default reminders: global timed default + separate all-day default + per-calendar override (timed), applied on create with dirty-flag handling; three pickers + override list in Settings → Notifications; battery-optimisation exemption row (status + system deep-link, no new permission). Plus system per-app language (Android 13+) and an immediate-effect fix for the in-app language picker

• v2.7 (shipped 2026-06-18) — the .ics engine: share a single event as .ics from the detail screen; back up local calendars (Settings → Calendars → Export) to a SAF file; open/receive an .ics — one event prefills the create form, many events open a bulk import into a chosen calendar (dedup by UID, skip-and-report unrepresentable VTIMEZONE / RECURRENCE-ID / guests). Hand-rolled serializer/parser, zero deps. Plus all-day single-day UTC fix and a widget R8 keep-rule crash fix

• v2.7.1–v2.7.5 (2026-06-21) — launch crash fix (listener before grant), user-controlled crash reporting, widget loading-spinner R8 keep rule, and F-Droid reproducible-build cleanups for the official repo

• [~] release/v2.8.0 (not yet cut) — crash reports via the public Codeberg tracker (MR !27) + reminder snooze/dismiss notification actions (MR !28, snooze self-schedules an exact alarm; primary delivery stays provider-broadcast)

Next

1. Cut v2.8.0 from release/v2.8.0 (bump versionName → tag via the merge-driven pipeline) once on-device review signs off
2. Attendee editing — the committed next feature (Tier 5 #12, high- importance, opened 2026-06-22). Attendees are already read & shown on the detail screen since v0.6; the gap is the write side — make guests editable in EventEditScreen / EventForm (add by typed email, role, remove), persisted by diffing CalendarContract.Attendees. No new permission for the typed-email path. Invitation behavior DECIDED 2026-06-22: record-only on all writable calendars — Calendula never sends (no INTERNET); honest backend-aware copy ("your account may email guests when it syncs" on synced calendars, "no one is notified" on local). Full sketch in ROADMAP.md → "Attendee editing".
3. Then: the two INTERNET go/no-go calls (OSM autocomplete, remote calendar create/edit) and Tier 2/3 leftovers (quick-settings tile, now-line, week numbers in month, full-text search, accessibility pass). Drag-and-drop rescheduling is rejected.