Repository navigation
Description
Summary
After spending an afternoon with this repository I am formally requesting that inkcal.sh be discontinued, archived, and possibly buried at a crossroads under a new moon.
The premise
"minimalist todo + calendar — vim-flavored, single JSON file, themeable."
Four buzzwords stapled to an Electron binary. "Minimalist" is doing competitive powerlifting in that sentence — the node_modules directory has more files than the U.S. Census. We shipped a 200MB Chromium instance so the user could press j and k. Bold.
The "vim-flavored" bit
It is j, k, dd, gg, G, and o. That is not vim flavoring. That is a vim-scented car air freshener. Real vim users are going to open this, type :wq, watch it do nothing, and never speak to us again. Fake vim users are going to press dd by accident and lose their grocery list (don't worry — there's a 5-second undo, which is exactly four seconds longer than the average human's "oh no" reflex).
The capture syntax
mwf 10:00-11:00 lecture
tr
fri: 331 hw3
Congratulations, we invented a DSL that requires a Rosetta Stone. r = thursday. u = sunday. Not th, not su — single letters, because vowels are for the weak. New users will type thu like a normal person, get a note titled "thu", and assume the app is broken. They will be correct.
The "single JSON file" architecture
Bold of us to advertise as a feature the thing every database was invented to replace. One unlucky JSON.parse away from a user's entire life dissolving into a SyntaxError. Yes, there are daily snapshots in backups/ for 30 days. No, the user does not know that. They will find out on day 31.
Themes
Three ship by default: dark, pink, light. The pink theme exists. I have no further notes on the pink theme. It speaks for itself, loudly, in pink.
The hot-reload-themes-from-a-folder feature is genuinely cute and will be used by exactly one person, who is the author. Everyone else will live in dark forever and resent us for making them scroll past pink in the palette.
The stack
electron-vite · react · tailwind · zustand · single json · ~1k loc
We used five frameworks to write 1,000 lines of code. That is one framework per 200 lines. At this density we should have just written it in bash and called it inkcal.sh — oh wait.
Functionality audit
- Todos: exist
- Calendar: allegedly exists
- Notes: suspiciously exists
- Reason to choose this over a
.txtfile: under investigation - Reason to choose this over Apple Reminders, which ships free, syncs, and was written by people with QA budgets: none found
Recommendation
- Archive the repo.
- Delete
~/Library/Application Support/inkcal-sh/from every machine that has ever run it, as a courtesy. - Open
Notes.app. Type your todo. You're done. You saved 200MB. - Reflect.
Severity
Existential.
Activity
inkitori commentedon May 4, 2026
yo
inkitori commentedon May 4, 2026
gurt