Contributing to Gitea
Thank you for your interest in contributing to Gitea! This guide will help you understand how to contribute to the project effectively.
Getting Started
Before you start contributing, please read our Hacking on Gitea guide to set up your development environment.
Contribution Guidelines
We have specific guidelines for different types of contributions:
Backend Development
If you're working on backend code (Go), please follow our Guidelines for Backend Development. This includes:
- Package design and dependencies
- Database operations and migrations
- Testing strategies
- Code organization
Frontend Development
For frontend contributions (JavaScript, CSS, Vue), refer to our Guidelines for Frontend Development. This covers:
- Framework usage (Vue3, Fomantic-UI)
- Code style and best practices
- Accessibility requirements
- TypeScript usage
Refactoring
When refactoring existing code, follow our Guidelines for Refactoring to ensure:
- Clear refactoring objectives
- Proper review process
- Maintaining backward compatibility
- Incremental improvements
Localization
To contribute translations or localization improvements, see our Localization Guide which explains:
- How to contribute translations via Crowdin
- Supported languages
- Translation workflow
Code of Conduct
Please be respectful and constructive in all interactions with the community. We are committed to providing a welcoming and inclusive environment for all contributors.
Getting Help
If you need help with your contribution:
- Join our Discord #Develop channel
- Visit our Forum
- Check existing GitHub Issues
Submitting Your Contribution
- Fork the repository
- Create a feature branch
- Make your changes following the relevant guidelines
- Write tests for your changes
- Ensure all tests pass
- Submit a pull request
For more details, see our CONTRIBUTING.md in the main repository.
Thank you for helping make Gitea better!