Thank you for considering contributing to PixivCompose! Your time and effort are greatly appreciated. This guide outlines the steps to contribute effectively.
- How Can You Contribute?
- Setting Up the Project
- Submitting a Pull Request
- Style Guide
- Reporting Issues
Here are some ways to contribute to the project:
- Reporting bugs or issues.
- Suggesting new features or enhancements.
- Writing or improving documentation.
- Submitting pull requests for fixes or new functionality.
- Reviewing existing pull requests.
- Fork the repository to your GitHub account.
- Clone your fork locally:
git clone https://github.com/your-username/PixivCompose.git
- Navigate to the project directory:
cd PixivCompose
- Install the required dependencies:
./gradlew build
- Run the tests to verify the setup:
./gradlew test
- Create a new branch for your changes:
git checkout -b feature/your-feature-name
- Make your changes and commit them:
git add . git commit -m "feat/fix(...): brief description of the feature/fix"
- Push the branch to your fork:
git push origin feature/your-feature-name
- Open a pull request:
- Go to the original repository on GitHub.
- Click the "New Pull Request" button.
- Select your branch and submit the pull request.
- Reference any related issues (e.g.,
Fixes #123
). - Ensure your branch is up to date with the main branch.
- Add tests for new features or bug fixes, if applicable.
- Follow the Style Guide.
- Follow the Kotlin Coding Conventions.
- Ensure all code is formatted using the project’s configured linter or formatter.
If you encounter a bug or want to suggest a new feature:
- Check the Issues tab to see if it has already been reported.
- If not, open a new issue and include the following:
- A clear and concise description.
- Steps to reproduce (for bugs).
- Expected vs. actual behavior.
- Relevant screenshots or logs, if applicable.
Thank you for contributing to PixivCompose! 🚀