Skip to content

feat(calendar): add Calendar and Tasks app#482

Open
TubalQ wants to merge 9 commits into
opencloud-eu:mainfrom
TubalQ:feat/web-app-calendar
Open

feat(calendar): add Calendar and Tasks app#482
TubalQ wants to merge 9 commits into
opencloud-eu:mainfrom
TubalQ:feat/web-app-calendar

Conversation

@TubalQ

@TubalQ TubalQ commented Jun 27, 2026

Copy link
Copy Markdown

Description

Adds web-app-calendar, a Calendar and Tasks extension for OpenCloud Web.

It is a pure frontend extension: it speaks CalDAV to the same-origin /caldav/ endpoint with the logged-in session, backed by the Radicale service that OpenCloud already advertises to clients through the support_radicale capability. There is no extra backend to run for local calendars and tasks.

Features:

  • Month, week, day, list and year views (FullCalendar).
  • Multiple calendars with per-calendar colour and visibility.
  • Tasks (VTODO): create, complete and delete.
  • iCalendar import and export per calendar.
  • Connect a calendar to other clients with its CalDAV link.

It follows the existing apps: package layout, defineWebApplication, i18n via $gettext, minimal runtime dependencies (FullCalendar and ical.js), and a unit test for the iCalendar handling.

Offered for your consideration. Happy to adjust naming, scope or structure to fit how you would prefer to carry a calendar app, or to close it if the timing or approach is not right.

Related Issue

No specific issue. This implements the calendar feature that has come up in community discussions.

How Has This Been Tested?

  • test environment: built and run in an OpenCloud deployment with Radicale enabled (CalDAV proxied at /caldav/).
  • test case 1: create, rename, recolour and delete calendars; create, edit, move, resize and delete events across all views.
  • test case 2: tasks (VTODO) create, complete and delete.
  • test case 3: iCalendar import and export per calendar.
  • checks: pnpm build, check:types, eslint and test:unit all pass.

Types of changes

  • Enhancement (a change that doesn't break existing code or deployments)
  • Tests (adding or improving tests)

TubalQ added 9 commits June 27, 2026 13:58
Adds web-app-calendar as a first-party extension: month/week/day/list/year
views, multiple calendars, tasks (VTODO) and iCalendar import/export. It is a
pure frontend extension that speaks CalDAV to the same-origin /caldav/ endpoint
backed by the Radicale service OpenCloud already advertises via the
support_radicale capability. External subscriptions and public sharing are
optional and handled by the companion oc-calendar-bridge service.

Builds, type-checks, lints and passes unit tests within the monorepo.
Add a 'bridge' flag (config.json) so the subscription and public sharing
features, which require the optional companion service, are hidden when no
bridge is deployed. The app then runs cleanly against CalDAV (Radicale) alone.
listSubscriptions/listPublications cast the response body directly; if the
bridge route is absent the proxy can return an SPA HTML fallback, and casting
that string to an array makes the UI iterate it character by character. Guard
with Array.isArray.
Remove the companion-bridge code path entirely (clients/bridge,
composables/useBridge, the subscription overlay and the subscriptions/sharing
panels). The app is now a self-contained CalDAV calendar and tasks app with no
optional backend dependency.
Wire FullCalendar to the active gettext locale so month and day names,
date formats and the first day of the week follow the user's language.
Format task due dates with the active locale. Add the Transifex config so
the app's strings can be translated upstream.
…ove a11y

Functional fixes:
- Apply recurrence overrides (RECURRENCE-ID) so a modified single occurrence
  shows its edited time and title instead of the series master's.
- Store all-day events and task due dates as floating DATE values built from the
  local calendar day, fixing an off-by-one in non-UTC timezones, and write an
  exclusive DTEND so a single all-day event is not zero-length.
- Write DTSTAMP and COMPLETED in UTC rather than floating local time.

CalDAV correctness and hardening:
- Return the server ETag from writes; resolve calendar-home-set with a principal
  fallback; check PROPPATCH multistatus results; normalize Apple 8-hex colors.
- Reject cross-origin multistatus hrefs and escape component names in request
  bodies.

UI and accessibility:
- Wire FullCalendar window comparisons to the exclusive end bound; guard against
  double-toggling a task; reformat the editor date fields when all-day flips and
  treat the all-day end as the inclusive last day.
- Add accessible names to the collapsed navigation and icon-only buttons, make
  iCalendar import keyboard operable, announce errors, and use plural forms.

Add unit tests for recurrence overrides and all-day round-tripping.
@TubalQ TubalQ marked this pull request as ready for review June 28, 2026 20:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant