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 6
SpaceX Founding Day
Falcon 9 launches upward with a flickering flame trail · An occasional Starship rises slower with a wider plume · Section dashes become 🚀 · "Making humanity multiplanetary" in the console
Preview →
May 8
No Socks Day
Striped socks tumble upward with chaotic spin · Section dashes become 🧦 · "Set your toes free" in the console
Preview →
2nd Sunday of May
Mother's Day
Soft pink petals tumbling down · MOM hearts rising up · Section dashes become 🌸 · A heartfelt console quote
Preview →
May 13
Top Gun Day
F-14 Tomcats streak across the upper sky with afterburner glow · Aviator sunglasses peek up from below · Section dashes become ✈ · "I feel the need... the need for speed!" in the console
Preview →
May 14
Dance Like a Chicken Day
A chicken bobs and wiggles its way across the page · Section dashes become 🐔 · "♪ Da-da-da-da-da-da-da! ♪" in the console
Preview →
May 20
World Bee Day
Bees zigzag across the page with a buzzing wing wobble · Section dashes become 🐝 · A pollinator quote in the console
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 →
1st Friday of June
National Donut Day
Glazed and chocolate donuts roll upward as they drift across the page · Section dashes become 🍩 · "Donut worry, be happy" in the console
Preview →
May 31
International Amiga Day
Boing Ball bouncing across the page with physics · Section labels become AmigaDOS prompts (
01>) · "Only Amiga makes it possible" in the console — in honor of Jay Miner
Preview →
June 16
Captain Picard Day
A child's-drawing banner of Picard wobbles across the page · Section dashes become Δ · "Make it so." in the console
Preview →
July 2
World UFO Day
A flying saucer drifts across the page with a glowing green tractor beam · Section dashes become 🛸 · "I want to believe." in the console
Preview →
July 4
Independence Day
Red-white-and-blue fireworks burst overhead · Spec US flags wave by, union-first (right-to-left or rising) · A bald eagle peeks in from a side edge · A sparkler trails the cursor · Section dashes become ⭐ · In 2026 (the 250th): golden "250" medallions rise, a grand finale flashes 250, and the official America250 mark drifts past · "Life, Liberty..." in the console
Preview →
July 10
Nikola Tesla Day
Electric sparks crackle around the cursor · Lightning bolts flash on screen · Section dashes become ⚡ · Tesla quote in the console
Preview →
3rd Sunday of July
National Ice Cream Day
Cones, sundaes and popsicles wobble gently up the page · Section dashes become 🍦 · "I scream, you scream..." in the console
Preview →
Sat before Labor Day
International Bacon Day
Sizzling bacon strips flop and wave across the page · Section dashes become 🥓 · "Everything is better with bacon" in the console
Preview →
September 19
Talk Like a Pirate Day
Jolly Roger flag flutters across the page · Section dashes become ☠ · "Ahoy, matey!" in pirate-speak in the console
Preview →
03 — One-off events
Once, then gone
June 11, 2026
2026 World Cup Kickoff
Soccer balls bounce and roll across the page with physics · Confetti bursts in the host nations' colors · A one-off for opening day (no badge)
Preview →
USA match days, 2026
USA at the 2026 World Cup
A ball is rocketed in from a lower corner, curls up the pitch and scores on you — GOAL! flash · Bouncing balls · Confetti in red, white & blue · Fires on each USA match day (no badge)
Preview →
Brazil match days, 2026
Brazil at the 2026 World Cup
A ball is rocketed in from a lower corner, curls up the pitch and scores on you — GOOOL! flash · Bouncing balls · Confetti in green, yellow & blue · Fires on each Brazil match day (no badge)
Preview →
04 — Testing
URL overrides
?egg=<id>— force-activate any egg regardless of date (comma-separate ids to run several at once)?egg=off— silence eggs even on their active date?egg=list— log the registry to the console (past one-off events hidden)
05 — 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.