Description
A board where anyone can follow what a team is building, comment on an item and say what they want next. The API lives in the same app, written with Hono and described by an OpenAPI schema, and clicking an issue opens a modal without losing the list behind it.
Features
- Intercepting routes: the same URL is a modal from the board and a full page from a shared link
- REST API in the same deploy, written with Hono and zod-openapi, with a generated reference
- Search and filters live in the URL, so a result can be pasted into chat
- Sign in with GitHub, or as a guest when no OAuth app is configured
- Comments and likes write through the API, not through a hidden path of their own
Challenges
- Prerendering the shell with Next 16 cache components, which meant awaiting route params inside the Suspense boundary rather than at the top of the page
- Getting a public environment variable into the browser bundle, which only works when each key is named in the code
- Keeping the like counter and the like table from disagreeing after a half-failed request
Learnings
- That a route handler which trusts its middleware still owes the type system a check, and the honest check is a 401 rather than a non-null assertion
- That an intercepting route is worth the extra file: keeping the list behind the modal is the whole reason people stop losing their place
- That a comment thread read newest first puts the answer above the question