eggs.adao.dev
Seasonal
easter eggs
for personal sites.
A tiny client-side library. Drop in one line, get atmospheric moments on the right dates — lightsabers on May 4th, floating burgers on May 28th, Marvin the Paranoid Android on Towel Day.
The site you're on right now is running it live. Check the bottom-right corner today,
or use the ?egg=<id> override to preview any egg.
01 — Install
One line in your HTML
Just before </body> on every page you want eggs on:
<script defer src="https://eggs.adao.dev/script.js"></script>That's it. Eggs activate automatically on their dates. Off-dates — nothing loads, no SVGs fetched, near-zero footprint.
02 — Eggs
What's in the calendar
May 4
May the Fourth
Gold lightsaber cursor trail · Section labels become Episodes · Millennium Falcon flyovers · Grogu peeks · Console message
Preview →
May 25
Towel Day
Floating towels drifting upward · Marvin the Paranoid Android peeks · Section numbers become 42 · Don't Panic console
Preview →
May 28
National Burger Day
Floating burgers drifting upward · Section dashes become 🍔 · Big Mac jingle in the console
Preview →
03 — Testing
URL overrides
?egg=<id>— force-activate any egg regardless of date?egg=off— silence eggs even on their active date?egg=list— log the full registry to the console
04 — How it works
Notes for the curious
- Pure vanilla JS — no build step, no dependencies, no framework.
- SVG art is lazy-loaded only when an egg activates. Off-dates fetch nothing beyond the script itself.
- Every visual respects
prefers-reduced-motion; touch devices skip cursor effects. - Decorative SVGs use
pointer-events: none, so they never block clicks underneath. - A persistent dismissible badge (bottom-right) gives non-fans context for what they're seeing.
- Self-locating: the script computes its own base URL, so
script.jsandimages/can live on a different origin from the embedding site.