Jean-Luc Makiola e194da3766
All checks were successful
CI / ci (push) Successful in 8m53s
Release — F-Droid repo + Gitea release / ci (push) Successful in 1m59s
Release — F-Droid repo + Gitea release / build-and-deploy (push) Successful in 8m57s
Release — F-Droid repo + Gitea release / gitea-release (push) Successful in 8s
release: cut v2.2.0 — tap-to-create + local calendar management
Day/week: tap an empty slot to open the create form prefilled with that
day and the tapped hour (snapped to the hour, 1 h long). Threaded a start
time through CalendarHost → EventEditScreen → openNew; the FAB keeps its
default.

Local calendars: a full-screen editor from Settings → Calendars to
create/rename/recolor/delete device-only calendars (ACCOUNT_TYPE_LOCAL,
sync-adapter insert) with name, pastel-previewed colour, and a description
(stored in CAL_SYNC1). Synced calendars are listed read-only grouped by
account, each with a "manage in source app" deep-link resolved from the
account's own authenticator (DAVx5/ICSx5/…), plus an add-account shortcut;
a <queries> block makes the source apps launchable. Extracted a shared
InlineTextField into ui.common so the event form and calendar editor share
one borderless input style.

Tests: repository delegation + write-failure, mapper isLocal/description,
fake data source extended. Version bumped to 2.2.0 / 20200.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-16 09:49:14 +02:00

Calendula icon

Calendula

A modern Material 3 Expressive calendar for Android.
Reads, writes, and reminds — on top of the system calendar, with zero network access.

CI Android 10+ Kotlin + Compose Material 3 Expressive MIT License

Week view  Month view  Event detail  Event form  Reminder onboarding

Calendula is named after the flower whose name — like the word calendar — comes from the Latin kalendae, the first day of the month. It lives entirely on top of Android's CalendarContract: any calendar synced to your device (CalDAV via DAVx5, Google, local, WebCal subscriptions, …) simply appears, and everything you create or edit syncs back the same way. No own database, no sync stack reinvented.

Features

Calendar

  • Month, week, and day views with a one-tap view switcher
  • Full event details — attendees and their responses, reminders, recurrence (humanized), availability, visibility, foreign time zones
  • Per-calendar visibility toggle, grouped by account

Editing

  • Create, edit, and delete events — including recurring events with scoped writes: only this event, this and all following, or the whole series
  • Recurrence picker with one-tap presets and custom rules (interval, weekday toggles, end conditions); rules it can't express are preserved verbatim
  • Conflict-safe saves: if an event changed elsewhere while you were editing, Calendula asks instead of silently overwriting
  • Read-only calendars (WebCal, birthdays) are detected and respected

Reminders

  • Event reminders delivered by Calendula itself as notifications — essential when it's your only calendar app, since Android delegates reminder delivery to calendar apps
  • Tap a reminder to land on the event

Design & privacy

  • Real Material 3 Expressive throughout — dynamic color (Android 12+), expressive motion and shapes, light/dark theme
  • German and English UI, per-app language setting
  • Zero telemetry, zero analytics, no internet permission — your data never leaves the device

📦 Install

Calendula ships through a self-hosted F-Droid repository; every version tag is built, signed, and published there automatically.

  1. Install an F-Droid client (F-Droid, Droid-ify, Neo Store, …).

  2. Add the repository — open this link on your phone, or paste it under Settings → Repositories → Add:

    https://apps.dev.jeanlucmakiola.de/dev/fdroid/repo?fingerprint=C2C0640402BF458FC0ED957AF0B37AA4C14022E72F89CE90B5965B458CF73425
    

    Repo: https://apps.dev.jeanlucmakiola.de/dev/fdroid/repo · fingerprint (SHA-256): C2C0 6404 02BF 458F C0ED 957A F0B3 7AA4 C140 22E7 2F89 CE90 B596 5B45 8CF7 3425

  3. Refresh, search for Calendula, install. Updates arrive like any other F-Droid app.

Alternatively, build from source — see below.

🛠 Building

Requires Android SDK 36+ and JDK 17. The Gradle wrapper is checked in:

./gradlew assembleDebug   # debug APK
./gradlew test            # JVM unit tests
./gradlew lint            # Android lint

If your default JDK is not 17, set JAVA_HOME explicitly.

🏗 Architecture

Single-activity Compose app, layered UI → Repository → DataSource → CalendarContract, observer-driven refresh, JVM-first tests. The full tour — including the recurring-write and reminder pipelines — lives in docs/ARCHITECTURE.md.

🗺 Roadmap

Shipped: read (v1.0), write (v1.1v2.0), reminder delivery (v1.4). Next up: power-user features — widget, search, tablet layouts. The living roadmap is in .planning/ROADMAP.md, the release history in CHANGELOG.md.

📜 License

MIT — Jean-Luc Makiola, 2026

Description
A modern Material 3 Expressive calendar app for Android
Readme MIT 3.1 MiB
v2.7.0 Latest
2026-06-18 14:24:35 +00:00
Languages
Kotlin 99.6%
Python 0.4%