Did you know that it was possible to easily share your Stackoverflow statistics using small dynamic images called "Flair"? This small image simply allows you to embellish your different READMEs like the one on GitHub or your online CV:

... and that just by adding the following Markdown:

![SO's Flair](https://stackoverflow.com/users/flair/USER_ID.png?theme=dark)

You can check them out at the URL https://stackoverflow.com/users/YOUR_USER_ID/YOUR_USER_NAME/flair :

This service proposed by Stackoverflow works very well, however since it hasn't be updated since a few years, there is some negative point that I noticed:

• the avatar image is weirdly cropped
• the only infos are the username, reputation score and badges amount
• it's a png so there is no fancy animation
• the image is very pixelated because of its small size (208x58)
• and most importantly: you cannot improve it because the project is not open-sourced

That's why I developed my own version of this service that would solve all these problems: stackoverflow-readme-profile

johannchopin / stackoverflow-readme-profile

Easily share your Stackoverflow's profile on your README

stackoverflow-readme-profile

Easily share your Stackoverflow's profile on your README.

---

⁉️ How to use?

You can generate your SO profile by calling this url with the corresponding template name and you SO user id:

https://stackoverflow-readme-profile.johannchopin.fr/:template/:id

Use it like that in your README:

[![johannchopin's SO profile](https://stackoverflow-readme-profile.johannchopin.fr/:template/:id)](https://github.com/johannchopin/stackoverflow-readme-profile)

---

📄 Templates

• profile
• profile-small

profile

Render a profile image by using the profile template:

https://stackoverflow-readme-profile.johannchopin.fr/profile/:id

Params (as query strings)

param	default	description
theme	default	Theme to use. Check them out here!
website	true	Show or not the website URL (true | false)
location	true	Show or not the location (true | false)

profile-small

Render a smaller profile image without the location and the website

Params (as query strings)

param	default	description
theme	default	Theme to use. Check them out here!

---

🐳 Docker

Build the image

You can build the image by using the following command:

docker build -t johannchopin/stackoverflow-readme-profile .

Push the

…

View on GitHub

This project allows you to embed improved version of those flairs wherever you want:

Default Stackoverflow profile:

Smaller profile:

Just use the following markdown schema to get your flair:

[![my SO profile](https://stackoverflow-readme-profile.johannchopin.fr/TEMPLATE_NAME/USER_ID?theme=dark)](https://github.com/johannchopin/stackoverflow-readme-profile)

Not yet convinced to use this project? I can understand why using an "unofficial" service doesn't seem like a good idea but here are some points that might change your mind:

• stackoverflow-readme-profile proposes a higher customisation with multiple themes and templates
• stackoverflow-readme-profile render a svg so the final image is pixel clear and is animated
• the project is open-sourced: You want a new feature or improve something? Just open an issue so we can collaborate together
• you want to self host the application? No problem there is already a docker image for that.

Thanks again for reading. If you are willing to see this project growing don't hesitate to leave a ⭐ to the repo and push your ideas of improvement.

johannchopin / stackoverflow-readme-profile

Easily share your Stackoverflow's profile on your README

stackoverflow-readme-profile

Easily share your Stackoverflow's profile on your README.

---

⁉️ How to use?

You can generate your SO profile by calling this url with the corresponding template name and you SO user id:

https://stackoverflow-readme-profile.johannchopin.fr/:template/:id

Use it like that in your README:

[![johannchopin's SO profile](https://stackoverflow-readme-profile.johannchopin.fr/:template/:id)](https://github.com/johannchopin/stackoverflow-readme-profile)

---

📄 Templates

• profile
• profile-small

profile

Render a profile image by using the profile template:

https://stackoverflow-readme-profile.johannchopin.fr/profile/:id

Params (as query strings)

param	default	description
theme	default	Theme to use. Check them out here!
website	true	Show or not the website URL (true | false)
location	true	Show or not the location (true | false)

profile-small

Render a smaller profile image without the location and the website

Params (as query strings)

param	default	description
theme	default	Theme to use. Check them out here!

---

🐳 Docker

Build the image

You can build the image by using the following command:

docker build -t johannchopin/stackoverflow-readme-profile .

Push the

…

View on GitHub