Skip to content

About

One question, three cards. The reader is bloub, a black ball that changes shape.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

bloub 塔罗

A tarot reader played by bloub: a curtain opens, one black ball asks what you want to know, thinks (it literally becomes three dots), deals three cards, and turns into each card as you flip it — its shape, its face, its colour, its move. All 22 major arcana are the same ball, frozen mid-state by the engine; there is not a single image on the page.

Live: https://bloub-tarot.alan996.workers.dev

Run it

pnpm install
pnpm dev        # http://localhost:5192
pnpm build      # tsc --noEmit && vite build
pnpm deploy     # build + wrangler deploy (Cloudflare Workers static assets)

bloub-react is linked from ../bloub-react until it is on npm: clone comedianhhh/bloub-react next to this folder first.

pnpm og regenerates public/og.svg from the engine; public/og.png is that SVG drawn on a 1200×630 canvas in the browser (scripts/og.mjs explains).

The reading

bloub never answers the question. After the third card it says four or five short lines that talk around it — a couple of fragments of mist per card, a few frames, a dice roll (src/oracle.ts). No network, no model, nothing to configure; the cryptic tone is the feature.

How it's laid out

src/App.tsx The show: phases (closed → open → cards → done), the timed beats, the spread, export
src/Seer.tsx BloubBot plus a tint lerp: the seer blushes into a card's colour and fades back
src/Card.tsx A card face is a BloubBot frozen at at seconds, inside a 120×200 SVG frame
src/cards.ts The 22 arcana as {state, at, shape, expression, react, color}
src/export.ts The three rendered faces + question → one 1920×1280 PNG
src/oracle.ts bloub's lines: mist fragments per card, frames, closers

Type and palette follow leerob.com: a serif reading face, warm greys, one accent (the reversed mark). Light and dark both work; card SVGs re-render on theme change because the engine bakes colours in.

License

MIT. bloub is MIT by Jérémy Perret; see LICENSE.bloub in bloub-react.

About

One question, three cards. The reader is bloub, a black ball that changes shape.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages