Skip to content

Branch Mate Project aims to streamline branch management and enhance collaboration for development teams. For more details and to contribute, visit Branch Mate.

License

Notifications You must be signed in to change notification settings

muraterennar/branch-mate

Repository files navigation

branch-mate

🌿 BranchMate

AI-Powered Git Branch Name & Commit Message Generator

Angular 19 TypeScript TailwindCSS .NET Core Gemini AI

🚀 Demo

https://branch-mate.vercel.app/

✨ Features

  • 🤖 AI-Powered Generation: Uses Google Gemini 2.0 Flash for intelligent suggestions
  • 🎯 Professional Standards: Follows GitHub best practices for naming
  • 🎨 Beautiful UI: Modern design with smooth animations
  • 📱 Responsive Design: Works perfectly on all devices
  • Real-time Generation: Instant AI-powered suggestions
  • 🌙 Dark Mode: Eye-friendly dark theme support

🛠️ Installation Steps

1. Clone the repository

git clone https://github.com/muraterennar/branch-mate.git
cd branch-mate

2. Install dependencies

npm install

3. Configure environment

# Copy environment template
cp src/environments/environment.ts src/environments/environment.local.ts

```bash
# Edit environment.local.ts and add your API configuration
# API_BASE_URL: 'https://localhost:5001'  # .NET Core API URL

<p>4. Start the application</p>

```bash
npm run start

The API will be available at https://localhost:5001 or http://localhost:5000

💻 Built with

Frontend Technologies

  • Angular 19 - Modern web framework
  • TypeScript 5.0 - Type-safe JavaScript
  • TailwindCSS - Utility-first CSS framework
  • RxJS - Reactive programming library
  • SCSS - Enhanced CSS with animations

Backend Technologies

  • .NET Core 9.0 - Cross-platform web framework
  • ASP.NET Core Web API - RESTful API framework
  • C# - Type-safe programming language
  • HttpClient - HTTP communication
  • Google Gemini 2.0 Flash - AI language model

Development Tools

  • Angular CLI - Project scaffolding
  • ESLint - Code linting
  • Prettier - Code formatting
  • Vercel - Frontend deployment
  • .NET CLI - Backend development tools
  • Swagger UI - API documentation
  • Visual Studio/VS Code - Development environment

📁 Project Structure

branch-mate/
├── src/
│   ├── app/
│   │   ├── components/
│   │   │   └── generate-info/          # Main form component
│   │   ├── core/
│   │   │   ├── components/
│   │   │   │   ├── ai/                 # AI button component
│   │   │   │   └── custom-button/      # Reusable button
│   │   │   ├── services/
│   │   │   │   ├── ai.service.ts       # AI API integration
│   │   │   │   ├── git.service.ts      # Git operations
│   │   │   │   └── theme.service.ts    # Theme management
│   │   │   └── models/
│   │   │       └── branch-data.ts      # Data models
│   │   └── environments/               # Environment configs
│   └── styles/                         # Global styles

🌟 Contributing

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📝 Environment Configuration

Frontend (.env)

API_BASE_URL=https://localhost:5001

🚀 Deployment

Frontend (Vercel)

# Build for production
npm run build

# Deploy to Vercel
vercel --prod

📊 Performance

  • Fast Response Times: AI generation in ~2-3 seconds
  • 📱 Mobile Optimized: Responsive design for all devices
  • 🎨 Smooth Animations: 60fps UI interactions

🛡️ License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Murat Eren Nar

⭐ Show your support

Give a ⭐️ if this project helped you!


Made with ❤️ for the developer community

About

Branch Mate Project aims to streamline branch management and enhance collaboration for development teams. For more details and to contribute, visit Branch Mate.

Topics

Resources

License

Stars

Watchers

Forks