Thank you for considering contributing to AlienUI React! Your contributions play a vital role in building a cutting-edge, inclusive, and highly customizable UI component library. This guide outlines how to get started and ensures a seamless contribution process for everyone involved.
-
Fork the repository.
-
Clone your fork to your local machine:
- Clone your fork to your local machine using the following command (replace
<your-username>
and<repository>
with your GitHub username and the repository name):
git clone https://github.com/<your-username>/<repository>.git
- Clone your fork to your local machine using the following command (replace
-
Add the Original Repository as a Remote:
- Change into the directory of your cloned repository:
cd <repository>
- Add the original repository as a remote (this helps you fetch changes from the original repository):
git remote add upstream https://github.com/<original-owner>/<repository>.git
-
Create a Branch:
- Create a new branch for your contribution (replace
<branch-name>
with a meaningful name):
git checkout -b <branch-name>
- Create a new branch for your contribution (replace
-
Make Changes :
- Pick a task or feature you'd like to work on. Check out the Issues tab for open task.
- Fix or build the task assigned to you on the
issues
tab, and then attach an image or recorded video to the Pull request (PR) of the UI you built.
-
Committing Changes
git add . git commit -m "Add your descriptive commit message here"
-
Fetch and Rebase from Upstream:
- Before pushing your changes, fetch the latest changes from the original repository and rebase your branch:
git fetch upstream git rebase upstream/main
- Resolve any merge conflicts if they occur.
-
Push your changes to your fork:
- Push your changes to your fork on GitHub:
git push origin <branch-name>
-
Open a Pull Request (PR):
- Visit your fork on GitHub and switch to the branch you just pushed.
- Click on the "New Pull Request" button.
- Provide a clear and descriptive title and rendered image or recorded video for your PR.
- Explain the purpose of your changes in the PR description.
- Ensure your code follows the project's coding standards.
- Be responsive to feedback and make necessary adjustments.
N/B: AlienUI React uses Firebase to manage the form database. Incase you encounter any error while configuring in your local machine, you can setup your own firebase project and populate you API KEY in your .env file. Just for testing purpose.
- Review and adhere to our Code of Conduct during your contribution.
If you love AlienUI React, consider giving the repository a ⭐ on GitHub! It motivates us to keep improving and building the component library. How to give the repository a star:
- Navigate to the top of the AlienUI React repository.
- Click on the "Star" button in the upper right corner of the page.
Thank you for being a part of AlienUI React! 👽