Almanac is a design-review tool that works like Figma's commenting feature: collaborators open a web page, drop pin-anchored comments directly on rendered HTML designs, and have threaded conversations right there on the artifact. It supports emoji reactions, resolving threads, live presence (seeing who else is looking), and even a special API lane for AI reviewers to participate alongside humans.
This repository contains no application code — only SEED.md, a single-file recipe that tells an AI coding agent exactly how to build the entire Almanac app from scratch. You hand the file to your agent, it installs everything it needs, writes all the code, and then runs a built-in suite of 27 acceptance checks against the running app on your own machine. No external services or production credentials required.
Key features:
- Pin-anchored comments on iframed HTML artifacts
- Threaded replies, emoji reactions, resolve/unresolve
- Live presence (who's viewing)
- AI agent API for automated reviewers
- Self-verifying with 27 acceptance journeys
- Built with Next.js 14, NextAuth, Vercel KV
- Works locally with in-memory fallback
