Thank you for considering contributing to DashPets! We appreciate your help in improving the project.
This guide outlines best practices for contributing, submitting issues, creating pull requests (PRs), and adding new pets.
When submitting an issue, please provide:
- Clear Title: Summarize the issue in a concise title.
- Description: Provide details about the problem, including steps to reproduce it.
- Environment: Mention relevant environment details, such as the browser, operating system, or device.
- Screenshots (Optional): Add images to clarify the issue if possible.
To submit a pull request:
-
Fork the Repository:
git fork https://github.com/yourusername/dashpets.git
-
Create a Branch: Name your branch descriptively, such as
feature/new-pet
orbugfix/tooltip-issue
.git checkout -b feature/new-pet
-
Write Clean Code:
- Follow the existing code style.
- Test thoroughly before committing.
-
Add Descriptive Commit Messages:
- Use clear, concise commit messages to explain your changes.
-
Open the Pull Request:
- Provide a detailed description of the changes.
- Link to any related issues or discussions.
-
Review and Feedback: Be open to constructive feedback from the maintainers.
When adding a new pet, please follow these guidelines:
- Image Format: Use square images with a consistent aspect ratio.
- Resolution: Ensure the images are optimized for web use without losing quality.
- Animation Types: Provide at least 2 images per animation type:
- Walk (mandatory)
- Run (mandatory)
- Sit (mandatory)
- Sleep (mandatory)
- Name the image files clearly (e.g.,
cat_walk_1.png
,cat_run_2.png
).
- Test the new pet animations in development mode (
yarn dev
). - Verify smooth transitions between animation states.
- Code Consistency: Follow the existing structure and use meaningful variable names.
- Documentation: Update any relevant documentation if your changes introduce new features.
- Respect: Be respectful and collaborative when interacting with other contributors.
We look forward to your contributions!