Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vinitshahdeo/peerlist-readme-badge

Markdown badge generator for any Peerlist profile 💚 | Style your GitHub Profile README with a Peerlist badge to showcase your work | Try out here: https://peerlist.io/tools/readme-badge
https://github.com/vinitshahdeo/peerlist-readme-badge

badge-generator hacktoberfest peerlist readme-badges

Last synced: 2 months ago
JSON representation

Markdown badge generator for any Peerlist profile 💚 | Style your GitHub Profile README with a Peerlist badge to showcase your work | Try out here: https://peerlist.io/tools/readme-badge

Host: GitHub
URL: https://github.com/vinitshahdeo/peerlist-readme-badge
Owner: vinitshahdeo
License: mit
Created: 2022-07-01T18:54:03.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2024-02-17T08:06:19.000Z (12 months ago)
Last Synced: 2024-07-11T14:00:05.920Z (7 months ago)
Topics: badge-generator, hacktoberfest, peerlist, readme-badges
Language: JavaScript
Homepage: https://vinitshahdeo.github.io/peerlist-readme-badge/
Size: 9.27 MB
Stars: 60
Watchers: 3
Forks: 25
Open Issues: 15
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

awesome-github-profile - Peerlist Profile Badge

README

        


  

    

  



Peerlist README Badge


![](./public/images/vinitshahdeo-peerlist-profile-cover.png)

Peerlist is a community of working professionals focused on building a personal brand, sharing professional content, and finding peers to collaborate with. **A [Peerlist profile](https://peerlist.io/vinitshahdeo) can be used as a simple resume or a complete portfolio to showcase your work. You can style your `README.md` with an awesome Peerlist markdown badge.** This has now been integrated into the official Peerlist platform, **try it out here: [peerlist.io/tools/readme-badge](https://peerlist.io/tools/readme-badge)**

:arrow_down: Below are a few examples:

| Peerlist User  | Badge  |

|:---|:---|

| [Akash Bhadange](https://peerlist.io/designerdada) | ![Peerlist](https://github-readme-badge.peerlist.io/api/designerdada) |

| [Pranjal Bareth](https://peerlist.io/pranjalbareth) | ![Peerlist](https://github-readme-badge.peerlist.io/api/pranjalbareth) |

| [Yogini Bende](https://peerlist.io/yogini)  | ![Peerlist](https://github-readme-badge.peerlist.io/api/yogini) |

| [Santosh Yadav](https://peerlist.io/santoshyadavdev) | ![Peerlist](https://github-readme-badge.peerlist.io/api/santoshyadavdev) |

| [Vinit Shahdeo](https://peerlist.io/vinitshahdeo) | ![Peerlist](https://github-readme-badge.peerlist.io/api/vinitshahdeo)  |

> [!WARNING]

> The author might be biased above, but you get the point! 😉

## :handshake: How to use?

Replace `vinitshahdeo` in the markdown with your Peerlist username. **Get a [Peerlist profile here](https://peerlist.io/) if you don't have one already!**

```markdown

![Peerlist](https://github-readme-badge.peerlist.io/api/vinitshahdeo)

```

![Peerlist](https://github-readme-badge.peerlist.io/api/vinitshahdeo)

### :art: Style your badge:)

Additionally it supports the styles. **To use a different style**: Replace `flat-square` in the markdown with any of the styles below. :point_down:

```markdown

![Peerlist](https://github-readme-badge.peerlist.io/api/vinitshahdeo?style=flat-square)

```

#### :traffic_light: Available styles

| Type  | Badge  |

|:---|:---|

| `flat` 
 _{This is the default style._{| ![Peerlist](https://github-readme-badge.peerlist.io/api/vinitshahdeo) |

| `flat-square`  | ![Peerlist](https://github-readme-badge.peerlist.io/api/vinitshahdeo?style=flat-square)  |

| `plastic`  | ![Peerlist](https://github-readme-badge.peerlist.io/api/vinitshahdeo?style=plastic)  |

| `social`  | ![Peerlist](https://github-readme-badge.peerlist.io/api/vinitshahdeo?style=social)  |

| `for-the-badge`  | ![Peerlist](https://github-readme-badge.peerlist.io/api/vinitshahdeo?style=for-the-badge)  |}}

> **Note** It's always preferable to include a link to your Peerlist profile in the `README` badge.

```markdown

[![Peerlist](https://github-readme-badge.peerlist.io/api/vinitshahdeo)](https://peerlist.io/vinitshahdeo)

````

[![Peerlist](https://github-readme-badge.peerlist.io/api/vinitshahdeo)](https://peerlist.io/vinitshahdeo)

## :notebook: API Documentation

[![Peerlist Badges Postman Collection](http://img.shields.io/badge/Postman-Collection-orange.svg?style=flat&logo=postman)](https://www.postman.com/restless-rocket-22186/workspace/peerlist-readme-badges/collection/6178851-67cf0bab-e978-4a37-b3ad-a5b3b42bf69e)

`GET baseUrl/:username` - please refer to the [Peerlist README Badges public Postman collection](https://www.postman.com/restless-rocket-22186/workspace/peerlist-readme-badges/collection/6178851-67cf0bab-e978-4a37-b3ad-a5b3b42bf69e) for the API documentation. Feel free to fork and use! You can directly run the collection in Postman by using the **Run in Postman** button below :point_down:

[![Run in Postman](https://run.pstmn.io/button.svg)](https://god.gw.postman.com/run-collection/6178851-67cf0bab-e978-4a37-b3ad-a5b3b42bf69e?action=collection%2Ffork&collection-url=entityId%3D6178851-67cf0bab-e978-4a37-b3ad-a5b3b42bf69e%26entityType%3Dcollection%26workspaceId%3D2f408deb-7005-42ba-a5c8-f68362aabfb5#?env%5BPeerlist%20Badges%5D=W3sia2V5IjoiYmFzZVVybCIsInZhbHVlIjoiaHR0cHM6Ly9wZWVybGlzdC1yZWFkbWUtYmFkZ2UuaGVyb2t1YXBwLmNvbSIsImVuYWJsZWQiOnRydWUsInR5cGUiOiJkZWZhdWx0In1d)

## :running_man: How to run locally?

[![Visual Studio](https://badgen.net/badge/icon/visualstudio?icon=visualstudio&label)](https://github.dev/vinitshahdeo/peerlist-readme-badge/) [![made-with-javascript](https://img.shields.io/badge/Made%20with-JavaScript-1f425f.svg?logo=javascript)](https://github.com/vinitshahdeo/peerlist-readme-badge/fork)

### :arrow_right: Setup

1. Install all dependencies

```bash

npm i

```

2. Start the Express app

```bash

npm start

```

> The above command will start a local server that listens on port `3000` for connections.

### :arrows_counterclockwise: Run

Visit `http://localhost:3000/`

```bash

http://localhost:3000/vinitshahdeo

```

> **Note** Please refer to the [Postman collection](https://www.postman.com/restless-rocket-22186/workspace/peerlist-readme-badges/collection/6178851-67cf0bab-e978-4a37-b3ad-a5b3b42bf69e) for the API documentation.

## :dart: What's next?

| Upcoming badge  | Inspired from  |

|---|---|

| ![Peerlist](https://github-readme-badge.peerlist.io/api?beta=true) | [![Twitter Follow @vinit_shahdeo](https://img.shields.io/twitter/follow/vinit_shahdeo?style=social)](https://twitter.com/Vinit_Shahdeo) |

*^{The above badge is dummy which can be retrieved using a query param: `beta=true` ⚠️}* 

The ultimate goal is to create a **dynamic markdown badge that displays Peerlist followers count** similar to the Twitter badge shown above. This is currently blocked on a public API to fetch the followers for a Peerlist user.

## :link: Online Badge Generator

[![Netlify Status](https://api.netlify.com/api/v1/badges/0988f5ca-a884-4372-9b13-fd725fdb9dd6/deploy-status)](https://app.netlify.com/sites/peerlist-readme-badge/deploys)

Try it out here: [peerlist-readme-badge.netlify.app](https://peerlist-readme-badge.netlify.app)

**Build locally** :point_down:

```sh

git checkout feature/web-app

cd client/peerlist-readme-badge

npm install

npm run start

```

## :rocket: Want to contribute?

[![GitHub issues](https://img.shields.io/github/issues/vinitshahdeo/peerlist-readme-badge?logo=github)](https://github.com/vinitshahdeo/peerlist-readme-badge/issues) [![GitHub pull requests](https://img.shields.io/github/issues-pr-closed/vinitshahdeo/peerlist-readme-badge?logo=github&color=green)](https://github.com/vinitshahdeo/peerlist-readme-badge/pulls)

Do you want to pitch in? If so, please consider developing a web app that generates the markdown badge dynamically based on the Peerlist username entered by the user. There will be an option to copy the markdown text. You can take inspiration from the [Badges Generator](https://badgesgenerator.com/).

> Check out open issues [here](https://github.com/vinitshahdeo/peerlist-readme-badge/issues). These are beginner-friendly issues for the participants of [Hacktoberfest'22](https://hacktoberfest.com/).

[![Forkers repo roster for @vinitshahdeo/peerlist-readme-badge](https://reporoster.com/forks/vinitshahdeo/peerlist-readme-badge)](https://github.com/vinitshahdeo/peerlist-readme-badge/network/members)

### Hacktoberfest 2022

![GitHub Hacktoberfest combined status](https://img.shields.io/github/hacktoberfest/2022/vinitshahdeo/peerlist-readme-badge?logo=digitalocean&logoColor=white)

As [Hacktoberfest'22](https://hacktoberfest.com/) is here, I have opened a few [beginner-friendly issues](https://github.com/vinitshahdeo/peerlist-readme-badge/issues) for newbies to get them started with open-source. Feel free to **open an issue**, **raise a pull request** or spread a word about the **[first-timers issues](https://github.com/vinitshahdeo/peerlist-readme-badge/issues)** opened here.

[![Twitter URL](https://img.shields.io/twitter/url?label=Tweet%20to%20spread%20a%20word&logo=twitter&style=social&url=https%3A%2F%2Ftwitter.com%2Fintent%2Ftweet%3Furl%3Dhttps%253A%252F%252Fgithub.com%252Fvinitshahdeo%252Fpeerlist-readme-badge%252Fissues%26via%3Dvinit_shahdeo%26text%3DHere%2527re%2520a%2520few%2520beginner-friendly%2520issues%26hashtags%3DHacktoberfest%252C%2520opensource%252C%2520hacktoberfest2022%252C%2520yourfirstPR)](https://twitter.com/intent/tweet?url=https%3A%2F%2Fgithub.com%2Fvinitshahdeo%2Fpeerlist-readme-badge&via=vinit_shahdeo&text=Here%27re%20a%20few%20beginner-friendly%20issues&hashtags=Hacktoberfest%2C%20opensource%2C%20hacktoberfest2022%2C%20yourfirstPR)

### Social Summer Of Code (SSoC)

[![Open Source Love](https://badges.frapsoft.com/os/v2/open-source.svg?v=103)](https://vinitshahdeo.github.io/peerlist-readme-badge/)

This project is shortlisted for a three-months-long Open Source Program([Social Summer Of Code](https://ssoc.devfolio.co/)) Organized By Social in order to promote open source with new age technologies & help beginners to kickstart their open-source journey. Please get started by introducing yourself [here](https://github.com/vinitshahdeo/peerlist-readme-badge/discussions/6).

> **Please refer to [SSoC.md](./SSoC.md) to get started.**



## Gratitude :heart:

A heartfelt thanks to the Peerlist team for adding this as a tool in their official platform: [peerlist.io/tools/readme-badge](https://peerlist.io/tools/readme-badge)

![](./public/images/peerlist-tools.png)

## :construction: Behind the scenes

Huge shoutout to [Shields.io](https://shields.io/) service for providing badges in the SVG format. :bow: Thank you [Pranjal](https://peerlist.io/pranjalbareth) for designing the poster.

![Deployed on Heroku](https://img.shields.io/badge/Deployed%20on%20Heroku-430098?style=flat&logo=heroku&logoColor=white)

## Stargazers 💚 

[![Stargazers repo roster for @vinitshahdeo/peerlist-readme-badge](https://reporoster.com/stars/vinitshahdeo/peerlist-readme-badge)](https://github.com/vinitshahdeo/peerlist-readme-badge/stargazers)

## Similar projects

Topmate is a platform to connect 1:1 with your audience & monetise your time better. Basically, one link to do it all ➥ [topmate.io/vinitshahdeo](https://topmate.io/vinitshahdeo). Even better, you can now **add a markdown badge** in your GitHub profile `README` to connect with your community!

[![Topmate](https://topmate-readme-badge.onrender.com/vinitshahdeo)](https://topmate.io/vinitshahdeo)

Here's `markdown` badge generator for your Topmate profile 

➥ [topmate-readme-badge](https://github.com/vinitshahdeo/topmate-readme-badge)

[![topmate-readme-badge](https://github-readme-stats.vercel.app/api/pin/?username=vinitshahdeo&repo=topmate-readme-badge)](https://github.com/vinitshahdeo/topmate-readme-badge)

## Author

[![GitHub WidgetBox](https://github-widgetbox.vercel.app/api/profile?username=vinitshahdeo&data=followers,repositories,stars,commits)](https://github.com/vinitshahdeo)

## :hugs: Sharing is caring!

**Did you like it?** :+1: If yes, please help me spread the Peerlist `README` badge. :green_heart: 


[![Twitter URL](https://img.shields.io/twitter/url?label=Tweet%20to%20spread%20a%20word&logo=twitter&style=social&url=https%3A%2F%2Ftwitter.com%2Fintent%2Ftweet%3Furl%3Dhttps%253A%252F%252Fgithub.com%252Fvinitshahdeo%252Fpeerlist-readme-badge%252Fissues%26via%3Dvinit_shahdeo%26text%3DHere%2527re%2520a%2520few%2520beginner-friendly%2520issues%26hashtags%3DHacktoberfest%252C%2520opensource%252C%2520hacktoberfest2022%252C%2520yourfirstPR)](https://twitter.com/intent/tweet?url=https%3A%2F%2Fgithub.com%2Fvinitshahdeo%2Fpeerlist-readme-badge&via=vinit_shahdeo&text=Here%27re%20a%20few%20beginner-friendly%20issues&hashtags=Hacktoberfest%2C%20opensource%2C%20hacktoberfest2022%2C%20yourfirstPR)

## :blue_heart: Wall of Love 

  
 

[![Twitter Follow @vinit_shahdeo](https://img.shields.io/twitter/follow/vinit_shahdeo?style=social)](https://twitter.com/Vinit_Shahdeo)

Show your support by [leaving a star](https://github.com/vinitshahdeo/peerlist-readme-badge/stargazers) or sharing your thoughts on [Twitter @vinit_shahdeo](https://twitter.com/Vinit_Shahdeo).