Live Demo: https://patch-note.vercel.app
PatchNote is an automated release notes generator built for product teams. It connects directly to your existing workflow tools like Linear and GitHub, pulls completed tickets and merged PRs, and generates polished, audience aware changelogs. It writes three distinct versions of your release notes: a user facing version, a technical developer version, and an executive summary.
Built originally for the Mind the Product Hackathon 2026.
Writing release notes is often a rushed, last minute task. PatchNote solves this by automating the entire process. Connect your workspace, select a date range, and the application does the rest. It uses the Gemini API to analyze your tickets and PRs, formatting them into clear, readable updates tailored to different audiences.
- Linear Integration: Securely connect your Linear workspace via OAuth to automatically fetch completed issues.
- GitHub Integration: Pull merged pull requests based on the selected date range.
- Audience Specific Generation: Powered by Gemini 3 Flash Preview, it creates unique changelog versions for users, developers, and executives.
- Public Changelog Page: A dedicated, server side rendered public page to share your user facing notes.
- Beautiful Design System: A cohesive dark mode interface tailored for readability and speed.
- Analytics Ready: Novus.ai snippet injected into the public pages to track reads and engagement.
- Framework: Next.js 16 App Router
- Styling: Tailwind CSS v4 and Base UI components
- Authentication: Clerk
- Database: Supabase PostgreSQL
- AI: Google Gemini API
- Integrations: Linear SDK
To run this project locally, follow these steps:
- Clone the repository.
- Run
npm installto install the required dependencies. - Apply the database schema located in the
supabase/migrationsfolder to your Supabase project using the SQL editor. - Duplicate the
.env.examplefile to.env.localand fill it with your actual API keys. - Run
npm run devto start the development server athttp://localhost:3000.
- Authentication: Users sign up securely via Clerk.
- Integration: Connect your Linear or GitHub workspace via OAuth 2.0.
- Data Fetching: Select a date range. The backend securely pulls all tickets marked as "Done" or PRs merged within that timeframe.
- AI Processing: The raw ticket data is fed into the Google Gemini API with a specialized system prompt, which parses the unstructured text and returns a structured JSON payload containing three beautifully formatted markdown changelogs.
- Publishing: The generated release notes are saved to a Supabase PostgreSQL database. Users get a unique, sharable public URL for their changelog.
This project is open source and available under the MIT License. See the LICENSE file for more information.