Welcome to First Commit, a project designed to help newcomers make their first contribution to open-source! This is a beginner-friendly initiative that guides you through the fundamentals of Git and GitHub—such as commands, pull requests (PRs), issues, and handling merge conflicts. With First Commit, you can easily gain hands-on experience by contributing to a real-world project.
First Commit provides an opportunity for developers who are new to open source to take their first step toward becoming contributors. It's a simple project where users add their information, such as their name, GitHub profile link, and designation (e.g., Open Source Enthusiast, UI/UX Designer). Your profile will be displayed as a card on the frontend.
Through this project, you’ll learn:
- 🛠 Basic Git commands
- 🐙 Exploring GitHub for collaborative coding and project management
- 🔧 Making and reviewing pull requests
- 📝 Creating and resolving issues
- ⚔️ Handling merge conflicts
Before you begin, ensure you have the following software installed:
- Fork this repository by clicking the "Fork" button at the top-right corner of this page.
- Clone the repository to your local machine:
git clone https://github.com/your-username/first-commit.git
- Navigate to the project directory:
cd first-commit
- Install the required dependencies:
npm install
- Start the project on your local server:
The project will now run on
npm start
http://localhost:3000
.
Ready to make your first contribution? Follow these steps:
- Fork the repository to your GitHub account.
- Create a new branch for your feature or fix:
git checkout -b feature/your-feature-name
- Make your changes to the codebase.
- Stage your changes:
git add .
- Commit your changes with a meaningful message:
git commit -m "Add [your-feature] - a brief description"
- Push the branch to your GitHub fork:
git push origin feature/your-feature-name
- Open a pull request (PR) from your forked repository by going to the original repo and clicking "New Pull Request."
- Ensure your code is clean and adheres to the project’s coding standards.
- Keep your commit messages clear and concise.
- Be respectful and considerate of others’ contributions.
Please adhere to our Code of Conduct. It's important to foster an inclusive and respectful environment for everyone involved.
This project is licensed under the MIT License. You can view the license file here.
Happy contributing! 🎉