changelog
Changelog
Add changelog entries as individual files in docs/changelog-entries/, then regenerate docs/changelog.mdx before opening or updating the PR.
Use a single long-lived branch for changelog automation: automation/changelog. The automation should update the existing open changelog PR from that branch when possible instead of opening multiple concurrent changelog PRs.
Principles
- User-facing only. No infrastructure, CI, security hardening, billing internals, queue fixes, cron changes, self-hosting features, or anything users don't directly see or interact with.
- Lead with a headline. Each entry has a theme name in the
descriptionfield (e.g., "Chat Everywhere", not "v2.28"). The theme should immediately tell users what changed. - One short paragraph explaining the headline feature — what it does and why it matters. Write for end users, not developers.
- 3–5 bullets max for other notable improvements in that release. If you can't fill 3 bullets, roll the changes into the next entry that has a strong headline.
- Skip releases without a standout feature. Not every deploy needs a changelog entry. Only write one when there's something worth headlining.
- Casual, clear tone. Use "you" and "your", not "users". No jargon. No version numbers as headlines.
Format
Create or update docs/changelog-entries/YYYY-MM-DD.mdx with frontmatter + markdown:
More from elie222/inbox-zero
ui-components
UI component and styling guidelines using Shadcn UI, Radix UI, and Tailwind
78security
Security guidelines for API route development
36fullstack-workflow
Complete fullstack workflow combining GET API routes, server actions, SWR data fetching, and form handling. Use when building features that need both data fetching and mutations from API to UI.
23test-feature
End-to-end feature testing — browser QA, API verification, eval tests, or any combination. Covers browser interactions (via agent-browser CLI), Google Workspace operations (gws CLI), API calls, and LLM eval tests. Can also persist tests as reusable QA flows or eval files.
21testing
Guidelines for testing the application with Vitest, including unit tests, integration tests (emulator), AI tests, and eval suites for LLM features
21project-structure
Project structure and file organization guidelines
21