bitmax
Go to file
monster 87cfead4d3 docs: complete the Dev Handbook
Adds the 5 chapters that hit a transient rate-limit on first pass:
- 01 Architecture & the Shared DNA
- 02 Building a New Volume (the Cookbook)
- 10 Vol I Internals — qBitTorrz
- 12 Vol III Internals — MACRO_VIRUS.XLS
- 13 Vol IV Internals — UPLINK

The Dev Handbook (Disc One) is now complete at 10 chapters; the Lore Bible (Disc Two) was already complete.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-14 16:21:31 +10:00
docs docs: complete the Dev Handbook 2026-06-14 16:21:31 +10:00
.gitignore Initial commit: BORING SOFTWARE — an anthology of incremental games 2026-06-14 15:44:36 +10:00
defrag.html Initial commit: BORING SOFTWARE — an anthology of incremental games 2026-06-14 15:44:36 +10:00
desktop.html Initial commit: BORING SOFTWARE — an anthology of incremental games 2026-06-14 15:44:36 +10:00
inbox.html Initial commit: BORING SOFTWARE — an anthology of incremental games 2026-06-14 15:44:36 +10:00
index.html Initial commit: BORING SOFTWARE — an anthology of incremental games 2026-06-14 15:44:36 +10:00
MANIFESTO.md Initial commit: BORING SOFTWARE — an anthology of incremental games 2026-06-14 15:44:36 +10:00
spreadsheet.html Initial commit: BORING SOFTWARE — an anthology of incremental games 2026-06-14 15:44:36 +10:00
terminal.html Initial commit: BORING SOFTWARE — an anthology of incremental games 2026-06-14 15:44:36 +10:00

BORING SOFTWARE

The Collector's Edition — Special Features

Five boring apps. Five hidden games. One operating system to hold them. This folder is the bonus disc: the dev commentary track and the world bible, bound together.


"Every boring app is a secret incremental game. Find the one already hiding in the chrome, and pull it out." — the founding line, MANIFESTO.md


What you hold in your hands

BORING SOFTWARE is an anthology of incremental games disguised as dead-serious utility software, circa 199899. You play them inside ENTROPY OS, a Windows-98-flavored desktop. Each volume reinvents not just the theme but the genre of interaction — a defragmenter you steer, a spreadsheet you compound, a terminal you escalate, an inbox you survive, a torrent client you seed.

This Collector's Edition is the material that ships in the limited box: two companion tomes.

  • THE DEV HANDBOOK — the engineering commentary track. How the whole thing is built, system by system, true to the source, including the candid post-mortems of every bug we shipped and caught.
  • THE LORE BIBLE — the world fleshed into chapters. The cosmology of ENTROPY OS, the five minds that wake up inside it, and the question every collector ends up arguing about.

You do not need either to play. They are here because some of you will want to take the machine apart, and some of you will want to live in it.

· · ·

The Anthology (the playable discs)

Volume App The reinvented interaction File
I qBitTorrz a torrent client seed data; climb hardware tiers; migrate to a seedbox cluster index.html
II DEFRAG.EXE a disk defragmenter steer the defrag; drag-select regions; outrun the rot defrag.html
III MACRO_VIRUS.XLS a spreadsheet build the engine in cells; drag-fill compounding formulas spreadsheet.html
IV UPLINK a terminal command line + live htop; manage load & heat; escalate to root terminal.html
V INBOX ZERO a mail client keyboard-triage an exponential inbox; write rules to automate it inbox.html
ENTROPY OS the desktop shell the launcher that holds them all desktop.html

To play: open desktop.html and double-click an icon.

· · ·

TABLE OF CONTENTS

Disc One — THE DEV HANDBOOK

Read this if you want to take the machine apart, or build Volume VI.

Disc Two — THE LORE BIBLE

Read this if you want to live in it. The Books can be read in any order; save the last two for last.

Spoiler warning. The Through-Line and Endings & The Void give away the shape of the whole thing. If you have not yet reached the top of a ladder yourself, you may want to wait.

· · ·

Also in the box

  • MANIFESTO.md — the original design manifesto. The thesis, the shared DNA, and the build specs the whole anthology grew from. The Rosetta stone for both tomes.
  • _STYLE.md — the canon & house style bible. The single source of truth that keeps nineteen chapters speaking with one voice. (Yes, you may read the writers' room notes.)

Colophon

Each game is a single self-contained .html file: inline styles and scripts, vanilla JavaScript, no libraries, no build step, no external resources. Double-click to run. Saves live in your browser's localStorage, one key per game. There is no server, no telemetry, no account. The whole machine fits in a folder you can put on a floppy — if a floppy were big enough, which, fittingly, it is not.

Numbers run from B to scientific notation. Minds run from a single bad sector to the Void.

· · ·

BORING SOFTWARE — Collector's Edition. Disc One: take it apart. Disc Two: live in it.