One button. Four phases of denial. Twenty-nine ways to do absolutely nothing useful.
You press it. It does nothing helpful. It does plenty of everything else. ๐
Live Demo ๐๏ธ ยท Report a Bug ๐ ยท Request a Feature ๐
If this repository wasted your time productively, consider leaving a star โญ. The button counts everything else anyway.
There are roughly one million tutorials that teach you to build a todo app. This is not one of them. ๐
The Chaos Button is a single-page interactive experience built around exactly one UI element: a large, suspiciously friendly button. Pressing it accomplishes nothing, and the button is honest about that. What it does instead is escalate. ๐
The first five clicks are innocent: a soft purple glow, a polite blip, a mildly philosophical remark. ๐ฃ By click ten the button has cracks, opinions, and trust issues. ๐ By click twenty your layout has gravity problems. ๐ At click twenty-six it surrenders entirely and throws a golden enlightenment ceremony, complete with an orchestral swell synthesized from raw oscillators and a thank-you card for your pointless dedication. โจ Then it forgets everything and starts over. Legally, nothing happened. Your localStorage disagrees. ๐งพ
This project exists because a button is the smallest possible unit of interactivity, and therefore the funniest place to spend an unreasonable amount of engineering. ๐ง๐
The engine counts your clicks and moves through four narrative phases. Each phase re-skins the page, swaps the sound palette, and unlocks new misbehavior. The button itself remembers nothing. Legally. โ๏ธ
| Phase | Clicks | Button label | Mood | What you see |
|---|---|---|---|---|
| 1๏ธโฃ Innocent Testing | 1โ5 | Press Me | ๐ Politely curious | Pristine purple glass button, slow breathing glow, mild weirdness |
| 2๏ธโฃ Active Resistance | 6โ15 | Stop That | ๐ Passive-aggressive | Cracks appear, colors desaturate, the button starts dodging and denying things |
| 3๏ธโฃ Total Chaos | 16โ25 | WHY | ๐คฌ Unhinged | Red vignette, glitching label, strobe, gravity stops working |
| 4๏ธโฃ Enlightenment | 26 | Thank You | ๐ง Transcendent | Golden ceremony, four-chord orchestral swell, a thank-you card, then a full reset |
- ๐ 29 behaviors, picked 1โ3 per press. Confetti cannons, alien abduction ๐ธ (with performance review), a hypnosis spiral, a bureaucratic permit form with a 50/50 approval rate, a therapist mode that asks how pressing made you feel ๐๏ธ, fake loading that stalls at 99% having loaded nothing, a button that runs away when you try to press it ๐, and one that gets shy and hides. ๐ซฃ
- ๐ 42 embedded quotes (obviously 42), from Socrates to Your Conscience.
- ๐ The Hall of Records: 33 lifetime statistics and 46 unlockable records, from Control Freak to Timeline Thief. Includes a Behavior Census with per-behavior dossiers ๐, threat ratings, suppress and mute switches, a Chaos Seismograph that draws your session as a mountain range โฐ๏ธ, and a Flight Recorder that logs your incidents like a black box with opinions.
โ๏ธ - ๐พ Backup export / restore and Duel Links โ๏ธ: compress your entire records ledger into one URL, send it to a friend with worse numbers, absorb their timeline. The better number always wins. This is the only fair system in the project.
- ๐ 100% synthesized audio. Every boing, pop, glitch, alarm, tractor-beam glissando and orchestral swell is generated live from oscillators and filtered noise. There are no audio files. There was never an audio file. ๐บ
- โก The Overcharge. Press and hold to charge a detonation, then release above 50% to regret it properly. ๐ฅ
- ๐ฅ The Double Tap. Two presses within a quarter second fork the timeline. Ghost buttons are included. Explanations are not. ๐ป
- ๐จ 5 themes (Midnight ๐, Daylight โ๏ธ, Sepia ๐ผ, Sodium
โ ๏ธ , Auto ๐) that every instrument respects, including the seismograph drum. - ๐ฎ The Konami code is accepted. Legally, nothing is unlocked. Emotionally, everything is. ๐น๏ธ
- ๐ช Press ranks from Bystander to Legend of the Lab. Yes, there is a ladder. No, it leads nowhere. That is the point.
# clone your fork (or the repo, we do not judge ๐)
git clone https://github.com/blankcode-alt/the-chaos-button.git
cd the-chaos-button
# install (bun) โ or use npm/pnpm, it is a standard Next.js app
bun install
# run the laboratory ๐งช
bun run devOpen http://localhost:3000. Press the button. ๐ด Keep pressing. Press it 26 times. Then press it 42 times, for reasons the page will explain with a straight face. ๐
๐ก Requires no API keys, no database, no accounts, no cloud, no mercy. Everything runs client-side and persists in
localStorage.
| Metric | Value |
|---|---|
| ๐ช Runtime behaviors | 29 |
| ๐ Unlockable records | 46 |
| ๐ Embedded quotes | 42 |
| ๐ Lifetime statistics tracked | 33 |
| ๐ช Press ranks | 11 |
| ๐จ Themes | 5 |
| ๐ Audio files shipped | 0 |
| โ Useful outcomes | 0 |
src/
โโโ app/
โ โโโ layout.tsx # metadata, fonts, the usual paperwork ๐
โ โโโ page.tsx # the stage: one page, one button, no routing
โ โโโ icon.svg # favicon, also a button, also useless
โ โโโ chaos.css # every theme, phase skin and animation
โ โโโ globals.css # tailwind entry
โโโ lib/chaos/
โ โโโ engine.ts # the conductor ๐ฉ: phases, behavior scheduling, easter eggs
โ โโโ effects.ts # stagecraft: shake, strobe, rotation, gravity incidents
โ โโโ audio.ts # the synthesized orchestra ๐ป
โ โโโ confetti.ts # the confetti physics department ๐
โ โโโ quotes.ts # 42 aphorisms and their long-suffering authors ๐งโ๐ซ
โ โโโ achievements.ts # the Hall of Records: stats, records, census, backups ๐
โ โโโ seismo.ts # the Chaos Seismograph โฐ๏ธ
โ โโโ settings.ts # the Control Room: themes, dials, persistence ๐๏ธ
โโโ components/ui/ # the handful of shadcn/ui primitives actually used
โโโ hooks/
โโโ use-toast.ts # toast plumbing
Built with Next.js 16, TypeScript, Tailwind CSS 4, a Canvas element, the Web Audio API and a plain CSS file. No animation libraries. No confetti packages. No webfonts you did not agree to. ๐งผ
Contributions are welcome. This is an open laboratory for high-effort uselessness, and the bar for entry is simple: does it make the button better at being a button? ๐งช
Good ideas that got merged before you arrived: gravity incidents, alien abduction, a permit form, an entire seismograph. The bar is on the floor and people still managed to limbo under it. ๐บ You can do better. ๐ช
- ๐ด Fork the repository
- ๐ฟ Create a branch:
git checkout -b feat/my-feature(orfix/, orchaos/, we are not strict about prefixes, only about fun) - โ๏ธ Make your change. Keep the copy deadpan. The humor is in the restraint.
- โ
Run
bun run lintandbun run typecheckso CI does not write a passive-aggressive comment about you - ๐ฌ Open a Pull Request and describe what your button does
๐ก Ideas currently accepting applications:
- ๐ชง A behavior where the button unionizes
- ๐ More records (the Hall of Records has room; it is very spacious for a panel)
- โฐ๏ธ A seismograph replay easter egg nobody asked for
- ๐ Translations of the gaslighting into additional languages, one of which is Morse code, one of which is not
- ๐คท Whatever you can think of that a reasonable product manager would reject
- ๐ You will absolutely press a button 100 times tonight, and future-you deserves to find this repo again
- ๐ It is a genuinely readable example of a zero-dependency-feel Next.js app: hand-rolled canvas physics, live-synthesized audio, a 2,000-line narrative state machine with comments that explain nothing and everything
- โญ Every star is counted, reported to no one, and deeply felt
- ๐ The button keeps a list. It prefers the people who starred.
MIT. Do whatever you want. The button has no legal claim on anything, including itself. โ๏ธ
โญ Star this repo if you pressed the button more than once. Yes, that includes you. ๐ โญ
The button counted. The button always counts. ๐ข