Inspiration
To-do lists feel like guilt lists: a pile of things you haven't done. I wanted finishing a task to feel like setting something free. So every task becomes a restless spirit haunting an abandoned manor, and completing it releases the spirit and restores a little of the house.
What it does
Spectral Tasks is a complete task manager: create, edit, delete, complete and reopen tasks; Today, Upcoming, All Tasks and Completed views; search and filters; and a daily goal. The haunting is part of how it works, not decoration:
- Completing a task releases its spirit: a wisp rises toward the manor and the ghost companion reacts.
- The manor moves through six stages, from a cold grey ruin to a warm amber-lit house.
- Progress is always derived from your real tasks, never a separate counter, so reopening or deleting a completed task can make the manor regress.
- A "Preview manor stages" control lets visitors see every stage without completing dozens of tasks.
- Demo data loads in one click so you can try the whole workflow.
Everything runs in the browser and saves to LocalStorage, with no accounts and no backend.
How we built it
I built it with Kiro using spec-driven development: 20 requirements with 187 acceptance criteria and 34 edge cases, a design document with 25 correctness properties, and a 17-task implementation plan (32 subtasks). The domain logic is pure TypeScript, tested with example tests and property-based tests (fast-check), for more than 260 passing automated tests.
Storage is defensive: corrupted data is backed up and verified before it is replaced, data written by a newer version puts the app in read-only mode, and the app falls back to memory if storage is unavailable.
For the interface, Kiro drove Playwright to screenshot the real app, so the manor art and layout were reviewed against what actually rendered, not just the code. I used the Impeccable design skill for critique and kept the stack lean: the only runtime dependencies are React, React DOM and Lucide.
Challenges we ran into
- Making the theme functional rather than decorative, so the manor is the progress display.
- Keeping animation from ever blocking the app: the spirit-release effect is a click-through overlay that never moves layout, and with reduced motion on it becomes a still ring.
- Getting the visuals right. The first screenshot review showed that early manor stages looked alike, the main form was below the fold at 1024x768, and the phone layout pushed the task list far down. Each was fixed and re-checked in the browser.
- Handling storage failures without ever losing user data.
Accomplishments that we're proud of
- A manor that tells the truth: its state follows real completed tasks.
- Careful storage recovery, with tests for corrupted data, newer schema versions, quota errors and unavailable storage.
- Accessibility built in: keyboard operation, visible focus rings, live-region announcements, 44px touch targets, text labels instead of color alone, and reduced-motion support.
- Measured performance, with honest caveats: on an older i5 laptop in headless Chromium with a production build, interactions took about 64 to 120 ms (median) and a 500-task cold load about 377 ms. Method and limits are in docs/performance.md.
- Automated browser QA across Chromium, Firefox and WebKit, with a manual QA checklist in the repo.
What we learned
- A spec with numbered acceptance criteria makes AI-assisted work easier to check, because every claim maps to a requirement.
- Looking at the real rendered app catches problems that reading code never will.
- New tests should be able to fail: I had Kiro temporarily break the app code to confirm the new tests caught it.
- Design tools can pull against your constraints, so I kept only the one skill that fit my no-extra-dependencies rule.
What's next for Spectral Tasks
- Optional sync across devices, while keeping the app fully usable offline.
- A richer payoff at the final manor stage.
- More ghost moods and more manor detail.
Built With
- css
- fast-check
- kiro
- localstorage
- playwright
- react
- typescript
- vite
- vitest