Release Notes by AI π€
Generate beautiful, professional release notes for your projects using AI. This tool helps developers and teams automatically create meaningful release notes from their code changes.
Features β¨
- π― AI-powered release notes generation
- π€ Multiple AI model support (OpenAI GPT and Anthropic Claude)
- π Model switching capability
- π» Modern React + TypeScript implementation
- π¨ Beautiful UI with Tailwind CSS and Radix UI components
- π Easy copy-to-clipboard functionality
- π Dark/Light mode support
- π± Responsive design
- π GitHub integration for repository analysis
Tech Stack π οΈ
- React - UI Framework
- TypeScript - Type Safety
- Vite - Build Tool
- Tailwind CSS - Styling
- Radix UI - UI Components
- React Query - Data Fetching
- React Router - Routing
- React Hook Form - Form Management
- Zod - Schema Validation
- OpenAI API - AI Integration
- Anthropic Claude API - AI Integration
Getting Started π
Prerequisites
- Node.js (v18 or higher)
- npm or yarn
- OpenAI API key (optional)
- Anthropic API key (optional)
Installation
-
Clone the repository:
git clone https://github.com/perryraskin/release-notes-by-ai.git cd release-notes-by-ai -
Install dependencies:
npm install # or yarn install -
Set up your API keys in one of two ways:
a. Using localStorage:
// Open your browser's developer console and run: localStorage.setItem("OPENAI_API_KEY", "your_openai_api_key_here"); localStorage.setItem("ANTHROPIC_API_KEY", "your_anthropic_api_key_here"); localStorage.setItem("GITHUB_TOKEN", "your_github_token_here");b. Using environment variables: Create a
.envfile in the root directory and add:VITE_OPENAI_API_KEY=your_openai_api_key_here VITE_ANTHROPIC_API_KEY=your_anthropic_api_key_here VITE_GITHUB_TOKEN=your_github_token_hereNote: You only need to set up the API key for the service you plan to use. The application supports both OpenAI and Anthropic models.
Note: You only need a GitHub token if you plan to generate release notes for private repositories.
-
Start the development server:
npm run dev # or yarn dev
The application will be available at http://localhost:8080
Building for Production ποΈ
To create a production build:
npm run build
# or
yarn buildContributing π€
Contributions are welcome! Feel free to:
- Fork the repository
- Create a new branch (
git checkout -b feature/amazing-feature) - Make your changes
- Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Please make sure to update tests as appropriate and adhere to the existing coding style.
License π
This project is licensed under the MIT License - see the LICENSE file for details.
Support πͺ
If you find this project useful, please consider giving it a βοΈ on GitHub!
For issues, feature requests, or questions, please use the GitHub Issues page.