Skip to content

About

One button. Four phases of denial. Twenty-nine ways to do absolutely nothing useful. Press it and it escalates: polite glow, passive-aggressive cracks, gravity problems, then a golden enlightenment ceremony. 100% synthesized audio, 46 unlockable records, zero useful outcomes. Stars are counted. The button counts everything.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Latest commit

ย 

History

11 Commits

Folders and files

Repository files navigation

Screenshot 2026-09-08 at 21 45 34

๐Ÿ”ด The Chaos Button

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. ๐Ÿ˜Œ

Next.js TypeScript Button Behaviors Records Embedded Quotes Sounds License PRs Welcome

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.


๐Ÿคจ Wait, what is this?

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. ๐Ÿ”ง๐Ÿ˜…

Gemini_Generated_Image_kp4ylfkp4ylfkp4y

๐ŸŽญ The four phases

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
Gemini_Generated_Image_t0tzuot0tzuot0tz

โœจ Highlights

  • ๐ŸŽŠ 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.

๐Ÿš€ Quick start ---ห… Screenshot 2026-09-08 at 21 25 23

# 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 dev

Open 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.

๐Ÿ”ข The numbers

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

๐Ÿ“‚ Project structure

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. ๐Ÿงผ

๐Ÿค Contributing

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. ๐Ÿ’ช

  1. ๐Ÿด Fork the repository
  2. ๐ŸŒฟ Create a branch: git checkout -b feat/my-feature (or fix/, or chaos/, we are not strict about prefixes, only about fun)
  3. โœ๏ธ Make your change. Keep the copy deadpan. The humor is in the restraint.
  4. โœ… Run bun run lint and bun run typecheck so CI does not write a passive-aggressive comment about you
  5. ๐Ÿ“ฌ 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

โญ Why star this?

  • ๐ŸŒ™ 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.

๐Ÿ“„ License

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. ๐Ÿ”ข

About

One button. Four phases of denial. Twenty-nine ways to do absolutely nothing useful. Press it and it escalates: polite glow, passive-aggressive cracks, gravity problems, then a golden enlightenment ceremony. 100% synthesized audio, 46 unlockable records, zero useful outcomes. Stars are counted. The button counts everything.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages