modem7/christmas-countdown repository overview

⁠Yet Another Christmas Countdown!

A self-hosted, self-contained countdown to Christmas — and then to New Year's — with a festive red-and-green design, animated flip-style digits, and snow that reacts to your cursor. No ads, no analytics, no social icons, just the countdown.

⁠Quick start

docker run -d --name christmas-countdown -p 8080:8080 modem7/christmas-countdown

Or Compose, if that's more your thing:

services:
  xmas:
    image: modem7/christmas-countdown
    container_name: Xmas-Countdown
    ports:
      - 8080:8080

Open http://localhost:8080 and enjoy.

⁠Detailed behaviour

• From January 2 to December 24: displays the number of days, hours, minutes and seconds left until Christmas.
• On December 25: displays "Merry Christmas!".
• From December 26 to December 30: displays "Happy Holidays!".
• On December 31: displays the number of hours, minutes and seconds left until New Year, with a green palette, champagne icons, and a gold spark overlay in place of the Christmas theme.
• On January 1: displays "Happy New Year!".

⁠What's actually in the image

• Static export from Next.js — fonts (Space Grotesk / Fraunces) and countdown logic are baked in at build time via next build, no server-side runtime
• Snow is a custom canvas layer (no third-party particle library) that swirls away from the cursor
• Served by nginxinc/nginx-unprivileged, runs as a non-root user, with security headers (CSP, X-Frame-Options, etc.) set in scripts/nginx/70-nginx.sh
• Multi-arch: amd64, arm64/v8

⁠Testing / CI

yarn lint and yarn test (Vitest — countdown date logic, phase derivation, and component rendering) run in GitHub Actions⁠ on every push and PR, alongside a Dockerfile build check (native amd64/arm64 runners, no QEMU).

A separate image test⁠ builds the real image, boots a container, and checks it end-to-end: security headers, gzip, /healthz, non-root/no-sudo/no-world-writable-files, and — via a Playwright script — that each countdown phase actually renders correctly.

.woodpecker.yml does the actual multi-arch build and Docker Hub push, triggered automatically on push to master (or manually, for on-demand rebuilds).

⁠Tags

⁠Credits

Originally based on plbrault/christmas-countdown⁠, since substantially redesigned.

⁠License

MIT, see LICENSE.txt⁠.