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.
- 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.
- Node.js 20+
git clone https://github.com/finos/calendar.git
cd calendar
cp .env.example .envSet 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 startOpen http://localhost:5173/.
| 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.
npm start # Vite dev server (proxies ICS feeds)
npm test # Vitest
npm run build # Vite production build
npm run lint # ESLint- Live combined ICS:
https://calendar.finos.org/calendar.ics - The site may be framed by
https://www.finos.organdhttps://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.
npm test