# mikeflynn/egg.js

A simple javascript library to add easter eggs to web pages.

Repository: https://github.com/mikeflynn/egg.js
Canonical: https://ross.abutalabs.com/products/eggjs
Homepage: https://mikeflynn.github.io/egg.js/
Language: JavaScript
License: MIT
License Family: permissive
Topics: easter-egg, javascript
Last push: 2022-02-26T18:32:49+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4158, "days_push": 1649, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1563, forks 97 (observed 2026-08-28T04:05:04.065136+00:00)

## What it is
Egg.js is a small dependency-free JavaScript library for adding easter eggs to web pages by detecting specific keyboard sequences like the Konami code. Developers register key sequences with callbacks and optional metadata, plus hooks that fire whenever any egg is triggered.

## Use cases
- add a konami code easter egg to my website
- trigger a fun animation when users type a secret key sequence
- detect keyboard shortcuts like up up down down left right left right b a
- fire an analytics event when someone finds my hidden easter egg
- add hidden surprises to web pages without dependencies

## When to choose
- you want a tiny, zero-dependency way to add keyboard-sequence easter eggs to any web page
- you want plain-English key names instead of raw JavaScript key codes
- you want hooks to log or track when easter eggs are discovered

## When to avoid
- you need general keyboard shortcut or hotkey management rather than playful easter eggs
- you need touch or mobile input support since it only watches keystrokes
- you need an actively developed library with modern tooling and TypeScript support

## Facets
- artifact type: library
- maturity: maintenance
- function: frontend-framework
- domain: web-development, frontend, entertainment
- platform: browser
- tags: easter-egg, konami-code, keyboard-events, vanilla-javascript

## Member repositories
- mikeflynn/egg.js (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:04.065136+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:00:16.166869+00:00, confidence not recorded.
  - readme: https://github.com/mikeflynn/egg.js (fetched 2026-08-28T04:05:04.065136+00:00, sha f6721ae223ee)
  - homepage: https://mikeflynn.github.io/egg.js/ (fetched 2026-08-29T11:29:15.073255+00:00, sha c383db21990a)
- Data as of 2026-08-30T08:39:29.467469+00:00.