Skip to content
finosPublic

About

FINOS Calendar

Resources

Code of conduct

Contributing

Stars

10 stars

Watchers

2 watching

Forks

Repository files navigation

FINOS Calendar

This app powers calendar.finos.org, which is also embedded on finos.org/calendar. It overlays two live feeds:

  • LFX meetings from the Linux Foundation public meetings JSON API (Project Meetings)
  • Custom events from the writable FINOS Google Calendar (finos.org_fac8mo1rfc6ehscg0d80fi8jig@group.calendar.google.com)

The page loads LFX meetings via /api/lfx-meetings (range-filtered) and custom events via /feeds/custom.ics. A merged subscribe feed remains at /calendar.ics (LFX + Google ICS). The Google ICS window covers the past month through the next 18 months.

Adding events

  • Recurring LFX project meetings belong in LFX Project Control Center.
  • Events LFX cannot represent yet go on the old FINOS Google Calendar only. Do not add LFX meetings there, or they will appear twice. The Google import calendar (@import.calendar.google.com) is read-only and is not used by this app.
  • Custom Google Calendar events are highlighted by default: bold, with a ★, pinned to the top of that day. LFX meetings stay in chronological order beneath them. A [highlight] tag in an existing title is still stripped and is not shown.

Prerequisites

  • Node.js 20+

Getting started

git clone https://github.com/finos/calendar.git
cd calendar
cp .env.example .env

Set LFX_ICS_URL in .env to the LFX Worker URL including the token. Optionally override GOOGLE_CUSTOM_ICS_URL (it defaults to the public ICS of the writable FINOS Google Calendar).

npm install
npm start

Open http://localhost:5173/.

Production env vars (Netlify)

Name Required Purpose
LFX_ICS_URL yes Full LFX Worker ICS URL, including ?token=
GOOGLE_CUSTOM_ICS_URL no Public Google Calendar basic.ics for custom events

Do not commit the LFX token. It is only used server-side by the ICS proxy.

Scripts

npm start      # Vite dev server (proxies ICS feeds)
npm test       # Vitest
npm run build  # Vite production build
npm run lint   # ESLint

Subscribe / embed

  • Live combined ICS: https://calendar.finos.org/calendar.ics
  • The site may be framed by https://www.finos.org and https://finos.org (Content-Security-Policy: frame-ancestors).

Clicking Invite Me on an LFX meeting opens the Zoom LFX registration page (invite=true). Custom Google events do not have that flow; use Event ICS or the event location instead.

Tests

npm test

About

FINOS Calendar

Resources

Code of conduct

Contributing

Stars

10 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages