calendula/.planning/STATE.md

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

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

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