This is an open-source project, and we welcome contributions from everyone. This guide will help you understand how to contribute.
By participating in this project, you agree to abide by our Code of Conduct. Please read it to understand what actions will and will not be tolerated.
If you find a bug, please open an issue on GitHub with:
- A clear and descriptive title
- A detailed description of the issue
- Steps to reproduce the issue
- Any relevant logs, screenshots, or error messages
- You can learn how from this video by Midudev
- How to Contribute to an Open Project on GitHub
Please follow these guidelines to keep the codebase clean and readable:
- Use meaningful and descriptive names for variables and functions.
- Keep functions and methods small and focused on a single task.
- Use comments to explain the purpose of complex code.
- Follow the existing coding style and conventions used in the project.
When working on a new feature or task, please follow this branch naming convention before merging in dev branch:
-
Feature Branches:
Use the prefixfeat/followed by a descriptive name of the feature being developed.
Examples:feat/login
-
Configuration Branches:
Use the prefixconf/for branches that involve configuration changes.
Examples:conf/firebase
-
Design Branches:
Use the prefixdesign/for design-related changes or improvements.
Examples:design/login
-
Commit Header:
Choose one of the following options based on the type of change made:ADD: For adding new features or files.FIX: For fixing errors or bugs.REFACTOR: For modifying code without changing its functionality.DELETE: For removing code, files, or other entities.DOCS: For changes related to documentation.
-
Commit Content:
Inside the parentheses(), specify what was modified in the commit. -
Commit Summary:
After:, provide a brief and clear summary of the change made.
- Keep commit messages clear and concise.
- Use present tense in the summary (
Implemented,Fixed,Refactored,Deleted,Documented) to indicate the action taken. - Ensure each commit represents a logical and coherent change in the code or documentation.
Your contributions make ColorPlayground better. Thank you for taking the time to contribute!