https://github.com/sahil-me/pull-shark-badge
Step-by-step guide to earn the pull shark badge! ✨
https://github.com/sahil-me/pull-shark-badge
badge contributors forked forked-repo github-badges open-source pair-programming pull-requests pull-shark
Last synced: 5 months ago
JSON representation
Step-by-step guide to earn the pull shark badge! ✨
- Host: GitHub
- URL: https://github.com/sahil-me/pull-shark-badge
- Owner: sahil-me
- License: mit
- Created: 2025-09-19T17:47:03.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-11-22T17:55:26.000Z (7 months ago)
- Last Synced: 2025-11-22T19:23:50.111Z (7 months ago)
- Topics: badge, contributors, forked, forked-repo, github-badges, open-source, pair-programming, pull-requests, pull-shark
- Language: Java
- Homepage:
- Size: 123 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# 🦈 Pull Shark Badge Guide ✨
Welcome to the **Pull Shark** Badge Guide!
This repo demonstrates how to earn the **Pull Shark** achievement badge on GitHub by successfully merging Pull Requests.
---
## 📢 Table of Contents
- [What is the Pull Shark Badge?](#-what-is-the-pull-shark-badge)
- [Requirements](#-requirements)
- [Step-by-Step Guide](#%EF%B8%8F-step-by-step-guide)
- [Solo Method](#1️⃣-solo-method-your-own-repo)
- [Contributor Method](#2️⃣-contributor-method-collaboration)
- [IDE Method](#3️⃣-ide-method-vs-code--intellij-idea--any-git-integrated-ide)
- [Git CLI Method](#4️⃣-git-cli-method-terminal)
- [Screenshots](#-screenshots)
- [When Will the Badge Appear?](#%EF%B8%8F-when-will-the-badge-appear)
- [Badge Levels](#-badge-levels)
- [Important Limitations](#-important-limitations)
- [Why This Repo?](#-why-this-repo)
- [Author](#-author)
---
## 📌 What is the Pull Shark Badge?
The **Pull Shark badge** is awarded when you **open and merge Pull Requests** on GitHub.
- **Symbol**: Symbolized by a shark 🦈 (sharks “pull” strongly through water 🌊).
- **Purpose**: Represents **good collaboration** because PRs are merged after contributing changes.
- **Unlock**: ✅ Earn it by merging your own PRs or having your PRs merged into someone else’s repository.
## 🔻 Requirements:
- **✅ Public repositories only** - PRs to private repos don't count
- **✅ Merged PRs required** - Open PRs without merging won't count
- **✅ Verified email** - Commit email must match your GitHub account email
- **✅ Default branch** - PRs must be merged into main/master branch
- **✅ Original authorship** - You must be the author of the PR
> ⚠️ **Important**: These requirements are critical for badge eligibility
---
## 🛠️ Step-by-Step Guide
### 👉 Four Ways to Earn the Pull Shark Badge
---
### 1️⃣ Solo Method (Your Own Repo)
- **Create a Repository**
- Name: `github-pull-shark-badge-guide`
- Public + README
- **Make a Change in a Branch**
- Create branch: `pull-shark-branch`
- Edit `README.md` or add `demo.txt`:
```bash
Testing Pull Shark badge – edited from pull-shark-branch
```
- **Open a Pull Request (PR)**
- Compare `pull-shark-branch` → `main`
- Title: *Demonstration: Pull Shark badge example*
- **Merge the PR**
- Click **Merge pull request** → Confirm merge
✅ Badge progress achieved!
---
### 2️⃣ Contributor Method (Collaboration)
- **Find open source projects** with labels like `@firstcontributions`
- **Fork** → **create branch** → **make small changes** (fix typos, update docs)
- **Open PR** to original repository
- **Wait for maintainer** to merge → badge progress increases
> 🏅 Tip: Repeat in multiple repos to reach higher badge levels (Bronze → Gold).
---
### 3️⃣ IDE Method (VS Code / IntelliJ IDEA / Any Git-Integrated IDE)
- IntelliJ IDEA Example
- Clone repo → `File → New → Project from Version Control`
- Create branch: `pull-shark-branch-ide`
- Edit `README.md` or `demo.txt`
```bash
Testing Pull Shark badge – edited from pull-shark-branch
```
- Commit & Push
- Open GitHub → **Compare & pull request** → Merge
- VS Code Example
- Install **GitHub** Pull Requests & Issues extension
- Clone repo → Create branch → commit → create PR → merge PR
---
### 4️⃣ Git CLI Method (Terminal)
- Clone repo
- git clone
```bash
https://github.com/your-username/github-pull-shark-badge-guide.git
```
- cd
```bash
github-pull-shark-badge-guide
```
- Create branch
- git checkout -b
```bash
pull-shark-branch-cli
```
- Make change
- echo
```bash
"🦈 Pull Shark demo change via Git CLI" >> demo.txt
```
- Stage & commit
- git add
```bash
demo.txt
```
- git commit -m
```bash
"Add Pull Shark demo change via CLI"
```
- Push
- git push
```bash
origin pull-shark-branch-cli
```
- Open GitHub → Compare & pull request → Merge PR → Confirm
🎯 Done via Git CLI!
---
## 📸 Screenshots
- Below are example screenshots to guide you.
> ⚠️ Note: Your screen may look slightly different depending on GitHub updates.
---
## ⏱️ When Will the Badge Appear?
- Usually within minutes on Profile → Achievements
- Sometimes up to 24 hours
> Note: If not showing → merge another PR
---
## 🏅 Badge Levels
The **Pull Shark** badge uses an "x" multiplier system:
| Level | Requirement | Badge Display |
|-------|-------------|---------------|
| **Initial** | 2 merged PRs | Pull Shark x1 |
| **Bronze** | 16 merged PRs | Pull Shark x2 |
| **Silver** | 128 merged PRs | Pull Shark x3 |
| **Gold** | 1,024 merged PRs | Pull Shark x4 |
> **Note**: The "x" number indicates achievement level, not separate badge types
---
## 🚫 Important Limitations
❌ **What Doesn't Count**
- **Private repository PRs**: Only public repos count
- **Unmerged PRs**: Open PRs without merge don't count
- **Wrong email**: Commit email must match GitHub account
- **Non-default branches**: Must merge into main/master
---
## ⭐ Why This Repo?
- Help new developers understand Pull Requests.
- Demonstrates Pull Shark badge
- Demonstrate GitHub’s fun achievement system.
- Covers UI, IDE, and CLI workflows
- Encourages collaboration & open-source contributions
✔ If this helped you → don’t forget to ⭐ star the repo!
---
## 🏆 Author
Made with ❤️ by [Sahil Sharma](https://github.com/sahil-me)
🎈 Happy contributing & badge collecting! :relaxed: