Card Desk #

A mechanical, first-person desk for reading public Bluesky posts, built with Three.js.

Run locally #

npm ci
npm run dev

Open http://localhost:5178/client/. The server defaults to port 5178; PORT and HOST can override its listening address.

The desk starts on Discover without a personal account. To read a particular account's public Following, Mutuals and Lists, open /client/?account=handle.example with the desired public handle. No sign-in or credentials are required. Likes and reposts made here stay on this desk.

Local outputs, environment files and editor configuration are excluded from Git. Audio source attribution and preparation notes are in client/sounds/README.md; those recordings remain subject to their source sample licenses.

Checks #

npm run test:mainframe
npm run test:tape
npm run test:audio
npm run test:machines
npm run test:printer
npm run test:performance