Events aggregator (#325)

* feat(events): add campus event aggregator (feeds + calendar embed)

* ci: run aggregator in build/deploy and add source health check

* feat(events): swap Teamup for self-hosted calendar + subscribe links

* fix(ci): run PR check on Node 24 and make events test runner node-version-proof

* ci(pr): install Chrome for Puppeteer so pa11y a11y step can run on Node 24

* ci(pr): skip Puppeteer auto-download, install Chrome explicitly (fix partial-browser pa11y failure)

* ci(pr): scope PUPPETEER_SKIP_DOWNLOAD to npm ci only so explicit Chrome install runs

* ci(pr): use the runner's system Chrome for pa11y instead of Puppeteer's download

* events: remove all-events subscription (confusable with network-wide)

* events: refine popover to use site brand colors)

* events: remove redundant link

* events: theme the embed to match the site (font, colors, dark mode)

- Render the calendar + popover in the site font (Atkinson Hyperlegible);
  aggregate-events.js vendors the woff2s to /fonts/ since MyST hashes static/
- Move every calendar + popover color onto :root variables (event tiles
  included) so the palette lives in one place
- Add prefers-color-scheme dark mode mirroring the site's dark palette
- Drop the stray internal scrollbar (overflow: hidden); the iframe is
  auto-sized to its content, so it never needs one

* events: don't vendor the embed font (it forced Atkinson site-wide)

The prior commit vendored Atkinson to /fonts/, which also satisfied the
site's own (previously-broken) @font-face and forced Atkinson across the
whole site. Drop the vendoring and the embed @font-face; the embed now
mirrors the site's font declaration with no webfont, falling back to the
reader's sans-serif like the rest of the site.

Author: LauraLangdon

.github/workflows/deploy.yml

@@ -3,6 +3,11 @@ name: Deploy to GitHub Pages
 on:
   push:
     branches: [main]
+  # Rebuild on a schedule so the aggregated event feeds (built by `make html`)
+  # stay current with upstream campus calendars even when no one pushes for a
+  # while.
+  schedule:
+    - cron: "0 */12 * * *" # every 12h
   workflow_dispatch:
 
 permissions:
@@ -19,6 +24,7 @@ jobs:
     # Do not attempt to deploy documentation on forks
     if: github.repository_owner == 'UC-OSPO-Network'
     runs-on: ubuntu-latest
+    timeout-minutes: 10
     steps:
       - uses: actions/checkout@v4
 

.github/workflows/pr.yml

@@ -21,7 +21,24 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
           cache: npm
 
+      # Puppeteer's own Chrome download is unreliable on the runner (it lands only
+      # partially, or the install no-ops), so skip it everywhere...
+      - run: npm ci
+        env:
+          PUPPETEER_SKIP_DOWNLOAD: "true"
+
+      # ...and point pa11y/Puppeteer at the Chrome the ubuntu image already ships.
+      - name: Point Puppeteer at the runner's system Chrome
+        run: |
+          CHROME="$(command -v google-chrome || command -v google-chrome-stable || command -v chromium-browser || true)"
+          echo "Using Chrome at: ${CHROME:-<none found>}"
+          test -n "$CHROME"
+          "$CHROME" --version
+          echo "PUPPETEER_EXECUTABLE_PATH=$CHROME" >> "$GITHUB_ENV"
+
       - run: make check
+        env:
+          PUPPETEER_SKIP_DOWNLOAD: "true"

.github/workflows/refresh-events.yml

@@ -0,0 +1,27 @@
+name: Validate event sources
+
+# Source-health alert for the campus event aggregator. Runs on a schedule and
+# fails loudly (red run + GitHub notification) if any campus feed breaks, so a
+# campus can't silently drop off the calendar.
+#
+# This does NOT deploy anything. Refreshing the live feeds is handled by the
+# scheduled run in deploy.yml (which rebuilds and redeploys to GitHub Pages).
+
+on:
+  schedule:
+    - cron: "0 */12 * * *" # every 12h
+  workflow_dispatch: {}
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+          cache: "npm"
+      - run: npm ci
+      # Exits non-zero (failing the run) if any source errors.
+      - run: npm run validate-events

Makefile

@@ -1,4 +1,4 @@
-.PHONY: help install html serve clean lint a11y check
+.PHONY: help install html serve clean lint a11y test check
 .DEFAULT_GOAL := help
 
 help:
@@ -11,15 +11,23 @@ html: ## Build MyST site in ./_build/html
 html: install
 	npx myst build --html
 	node scripts/generate-feed.js
+	node scripts/aggregate-events.js
 
 serve: ## Serve MyST site locally (live reload)
 serve: install
 	npx myst start
 
 lint: ## Check for broken links in the built site
 lint: html
-	npx linkinator ./_build/html/
-
+	npx linkinator ./_build/html/ --skip /events-embed.html
+
+# Accessibility. The embed (/events-embed.html) is not in the sitemap, so it is
+# audited separately below with `pa11y`. The --ignore'd codes are
+# FullCalendar-internal ARIA issues in its table markup that we cannot fix
+# without patching the library (fullcalendar/fullcalendar #7707, #7568, #6526).
+# Ignoring them is safe: the calendar was manually verified to be
+# keyboard-operable (Tab to an event, Enter opens its details popover), so the
+# ignores do not mask a real keyboard barrier.
 a11y: ## Run accessibility checks against the built site
 a11y: html
 	npx serve _build/html -p 4117 & \
@@ -28,10 +36,19 @@ a11y: html
 	timeout 30 bash -c 'until curl -s http://localhost:4117 > /dev/null; do sleep 1; done'; \
 	npx pa11y-ci --sitemap http://localhost:4117/sitemap.xml \
 		--sitemap-find 'http://localhost:[0-9]+' \
-		--sitemap-replace 'http://localhost:4117'
-
-check: ## Run full build + lint + accessibility (same as CI)
-check: lint a11y
+		--sitemap-replace 'http://localhost:4117' && \
+	npx pa11y --standard WCAG2AA \
+		--ignore "WCAG2AA.Principle1.Guideline1_3.1_3_1.F92,ARIA4" \
+		--ignore "aria-prohibited-attr" \
+		--ignore "role-img-alt" \
+		http://localhost:4117/events-embed.html
+
+test: ## Run unit tests (no build needed)
+test: install
+	npm test
+
+check: ## Run unit tests + full build + lint + accessibility (same as CI)
+check: test lint a11y
 
 clean: ## Remove built files
 clean:

events/index.md

@@ -4,11 +4,19 @@ title: Events
 
 ## Calendar
 
-<iframe title="UC OSPO Network event calendar" src="https://teamup.com/ksm2uwujdk3osj73h9?tz=Calendar%20default&showProfileAndInfo=0&showSidepanel=1&showViewHeader=1&showAgendaDetails=0&showDateControls=1&showDateRange=1" style="width: 100%; height: 800px; border: 1px solid #cccccc" loading="lazy" frameborder="0"></iframe>
+<iframe title="UC OSPO Network event calendar" src="/events-embed.html?v=6" loading="lazy"></iframe>
 
-:::{tip}
-Please note: if you add an event from the embedded calendar above, it will default to "Does not repeat". If you'd like to add all instances of a recurring event, please use the .ics file or the "Add to your Google calendar" button for the event below.
-:::
+## Subscribe
+
+Add UC OSPO events to your own calendar app (Google, Apple, Outlook). Subscribe to as many feeds as you like:
+
+- [**Network-wide events**](https://ucospo.net/feeds/network.ics) (all-campus meetups and network-level events)
+- By campus:
+  - [**UC Davis**](https://ucospo.net/feeds/davis.ics)
+  - [**UC Santa Barbara**](https://ucospo.net/feeds/ucsb.ics)
+  - [**UC Berkeley**](https://ucospo.net/feeds/berkeley.ics)
+  - [**UC San Diego**](https://ucospo.net/feeds/ucsd.ics)
+  - [**UC Santa Cruz**](https://ucospo.net/feeds/ucsc.ics)
 
 ## Upcoming Events
 

netlify.toml

@@ -3,7 +3,7 @@
 
 [build]
   publish = "_build/html"
-  command = "npm ci && npx myst build --html && node scripts/generate-feed.js && npx linkinator ./_build/html/"
+  command = "npm ci && npx myst build --html && node scripts/generate-feed.js && node scripts/aggregate-events.js && npx linkinator ./_build/html/ --skip /events-embed.html"
 
 [context.deploy-preview]
   ignore = "false"