KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #codex #claude-code #cli #react #mcp #open-source #deepseek-harness #dsh-plugin #ai

css-dos

★ 40 Open GitHub ↗

CSS-DOS: An Intel 8086 PC running DOS — implemented entirely in CSS

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Css-DOS logo](https://raw.githubusercontent.com/stop-amertime/css-dos/master/icons/css-dos-logo-narrow-A.png.png)

**CSS-DOS - an entire ’80s PC implemented in pure CSS, running Windows 1.01, MS-DOS, DOOM and more.**

An 8086 CPU, chipset, 640 KB RAM, floppy drive, keyboard, mouse and
screen - in one `.css` file. It’s a morbidly obese 300+ MB of
spec-compliant CSS, abused beyond recognition: some of the most
delightfully painful and wasteful code ever cursed to exist.

It boots **Microsoft Windows 1.01** and its namesake **MS-DOS**, and
runs real ’80s software. Yes, it runs **DOOM**.\*

<sub>\* barely.</sub>

### ▶ [Try it in your browser here](https://css-dos.ahmedamer.co.uk)

### How is this possible?
This question is tackled in depth [here]( https://css-dos.ahmedamer.co.uk/#about/how)

### How does it work? 
See the ✨🌟[full interactive walkthrough](https://css-dos.ahmedamer.co.uk/#about/file/map)✨

### Did you use AI?
I've commented on this extensively [here](https://css-dos.ahmedamer.co.uk/about/faqs/ai).

### How is performance?

A browser evaluates all of this at roughly **two instructions per
second** - three weeks to boot DOS, if it didn’t freeze first. So the
sibling project [**Calcite**](https://github.com/stop-amertime/calcite),
a JIT compiler for computational CSS (Rust → WebAssembly), runs the
same file **200,000× faster** - without adding, changing, or removing
a single byte of it, and bound by the project’s cardinal rule: it must
produce exactly what a spec-compliant browser would, byte for byte.
[Why that isn’t cheating →](https://css-dos.ahmedamer.co.uk/#about/calcite)

## The 30-second version (for developers)

A **cart** (folder or zip) contains a DOS program. The **builder** takes
a cart, picks a **BIOS**, assembles a **floppy**, feeds it to **Kiln**
(the transpiler), and produces a **cabinet** - a self-contained `.css`
file. You play a cabinet in Chrome via the **player**, or fast via
Calcite.

```
$ node builder/build.mjs carts/rogue -o rogue.css
$ npm run dev                              # Vite dev server on :5173
$ open http://localhost:5173/build.html    # build/load the cabinet, then play
```

Or run it fast through Calcite:

```
$ ../calcite/target/release/calcite-cli -i rogue.css
```

## Vocabulary

| Word | Meaning |
|---|---|
| **cart** | Input folder or zip: a program, any data files, optional `program.json`. |
| **floppy** | FAT12 disk image the builder assembles from a cart. Internal. |
| **cabinet** | The built artifact - a single `.css` file, runnable. |
| **Kiln** | The transpiler. Turns an 8086 memory image into CSS. |
| **builder** | Orchestrator. Wires up BIOS → floppy → Kiln. |
| **BIOSes** | Three flavors: **Gossamer** (hack-path shim), **Muslin** (assembly DOS BIOS), **Corduroy** (structured C DOS BIOS, default). |
| **player** | Static HTML at `web/player/calcite.html`; loads `/cabinet.css` (served from the SW cache via `build.html`). |
| **Calcite** | Sibling repo: the JIT that runs cabinets fast. |

## Start here

- New to the project? → [`docs/architecture.md`](docs/architecture.md)
- Making a cart? → [`docs/cart-format.md`](docs/cart-format.md) + [`docs/building.md`](docs/building.md)
- Hacking on the codebase? → [`CLAUDE.md`](CLAUDE.md) + [`docs/INDEX.md`](docs/INDEX.md)

## Repo layout

```
builder/         Orchestrator CLI and stages
kiln/            The transpiler (née transpiler/src)
bios/
  gossamer/      Hack BIOS
  muslin/        Assembly DOS BIOS
  corduroy/      Structured C DOS BIOS (default)
web/             Front-end: player (calcite.html, raw.html, bench.html), shim, dev server, prebake bins
                 Build/load page: web/site/build.html. Service worker: web/site/sw.js
conformance/     Reference emulators for diff testing
carts/           Example carts
dos/             DOS kernel + COMMAND.COM
tools/           Build utilities (mkfat12, image converters, js8086)
tests/           Conformance test programs
docs/            Full documentation
legacy/          Archived earlier approaches
```

## Status

See [`docs/logbook/STATUS.md`](docs/logbook/STATUS.md) for the live
project status. Current default cabinet path boots DOS + the cart's
program end-to-end. Rom-disk mechanism exposes disks outside 8086
memory, so cabinet size is no longer bounded by a floppy size.

## Credits

- Lyra Rebane ([rebane2001](https://github.com/rebane2001)) - the
  original [x86css](https://github.com/rebane2001/x86css), a 16-bit
  x86 CPU in pure CSS. CSS-DOS grew out of it.
- Jane Ori - the [CPU Hack](https://dev.to/janeori/expert-css-the-cpu-hack-4ddj).
- [emu8](https://github.com/nicknisi/emu8) - the reference 8086 emulator.
- [Doom8088](https://github.com/FrenkelS/Doom8088) by Frenkel Smeijers -
  id Software’s DOOM, ported to the 16-bit 8088/8086.
- EDR-DOS via [SvarDOS](https://svardos.org/), and Microsoft’s
  [MS-DOS 4.00](https://github.com/microsoft/MS-DOS) (MIT, 2024).

Full credits on [the site](https://css-dos.ahmedamer.co.uk/#about/credits).

## License

GNU GPLv3.

css-dos

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README