Cardwhisper (Tarot Desktop)
In progressDesktop AppsStack: Electron · React · Vite · TypeScript · Vitest · PostgreSQL · Docker · Kubernetes · GitHub Actions
Cardwhisper is my largest project: a desktop tarot reading app, built in about five weeks (201 commits), with a lot of the work going into architecture and written decisions rather than screens.
What I built
- Three reading modes (a desktop reading mat, free drag-and-drop, and object-based drawing), a custom spread editor with import / export codes, and a local reading journal with statistics.
- The Windows version is complete, and the Mac App Store signing and sandbox pipeline is working.
- 16 architecture decision records covering draw modes, persistence, accounts and memberships, the payment boundary and App Store packaging.
- A designed and implemented account, membership and refund backend (Stripe, PostgreSQL, container and Kubernetes specs, AWS S3 Object Lock for audit retention). This backend is not launched.
- A test suite of roughly 70k lines across ~300 test files, and three CI workflows.
Status: in development and not released. The code is private; I'm happy to walk through the architecture documents in an interview.
中文:牌语 Cardwhisper 是我体量最大的项目,约五周完成 201 次提交,重点放在架构和决策记录上。包含三种抽牌模式、自定义牌阵编辑器、本地占卜记录;Windows 第一版已完成,Mac App Store 的签名与沙盒流水线已打通。写了 16 篇架构决策记录,并设计实现了账户、会员与退款后端(Stripe、PostgreSQL、K8s 部署规格),该后端尚未上线。目前未对外发布,源码为私有仓库。
The source code for this project is private, so screenshots and notes are shown here instead. Happy to walk through the code on request.