Welcome to our open-source React project, which is powered by Vite! This guide will assist you in navigating the contribution process, ensuring a smooth and productive experience. Let's dive right in! π οΈ
Before you get started, please ensure that your system has the following software installed:
- Git: A version control system. You can download it here π§βπ»
- Node.js: A JavaScript runtime. You can download it here π’
- npm: The Node Package Manager, which comes included with the Node.js installation π¦
- Start by forking this repository. Simply click the "Fork" button located in the top right corner of this page. π
-
Next, clone your forked repository to your local machine. Go to your GitHub account, open the forked repository, click the "Code" button, and copy the repository's URL. Then, open your terminal and execute the following command:
git clone "URL you just copied"
Replace "URL you just copied" with the URL you obtained from your forked repository. π₯οΈ
The code will look something like this :
git clone https://github.com/{your user name}/StarterHive.git
- Change your terminal's current directory to the project's "web" folder:
cd StaterHive/web
In the web directory, install the required dependencies by running the following command:
npm install
This command will download and install all the packages specified in the project's package.json file. π₯
Create a new branch for your work. It's best to choose a branch name that clearly reflects the purpose of your changes. Use the following command:
git checkout -b my-feature
- Replace "my-feature" with a descriptive branch name. π
Now, you can make the necessary code adjustments using your preferred code editor. To test your changes locally, run the project with:
npm run dev
This command initiates the development server and builds the project. Open your web browser and visit the provided URL to observe your changes. Thoroughly test to ensure everything functions as expected. β
Once you're satisfied with your changes, it's time to commit them. First, stage your changes with:
git add .
-
This command stages all modified files.
-
Commit your changes with a descriptive message:
git commit -m "Add my feature"
-
Replace "Add my feature" with a brief description of your changes. π
-
Push your changes to your forked repository:
git push origin my-feature
- Replace "my-feature" with the name of your branch. π’
Head over to the main repository on GitHub. You should see a message indicating that you've recently pushed a branch. Click on the "Compare & pull request" button. π
Review your changes and provide a meaningful title and comment for your pull request. π¬
Finally, click "Create pull request" to submit your contribution. π€
Congratulations! You've successfully contributed to our Vite-powered React project. Our project maintainers will review your pull request. π
Thank you for your valuable contribution! π