pixel-profile
TypeScript icon, indicating that this package has built-in type declarations

0.1.1 • Public • Published

Pixel Profile Pixel Profile: Generate pixel art profiles from your GitHub data

This Pixel Profile project would not have been possible without these three amazing projects:

Github Readme Stats: One of the best tools out there for generating awesome Github stats cards.

resvg-js: A high-performance SVG renderer and toolkit.

Satori: An enlightened library to convert HTML and CSS to SVG.

Overview

You can easily generate a Github stats card with default styling using the following link:

<!--Replace <username> with your own GitHub username.-->
https://pixel-profile.vercel.app/api/github-stats?username=<username></username>

Default Github Stats Card

Of course, you can customize the styling to better suit your preferences. For example, here is a stats card designed for GitHub's Dark Theme::

https://pixel-profile.vercel.app/api/github-stats?username=LuciNyan&screen_effect=true&background=linear-gradient(to%20bottom%20right%2C%20%232aeeff%2C%20%235580eb)

This is what it looks like in use in a README:

Demo 1

If you want to include a GitHub stats card in your own README and have it display the appropriate card for both light and dark themes on GitHub, you can use the following configuration:

<picture decoding="async" loading="lazy">
  <source media="(prefers-color-scheme: light)" srcset="https://pixel-profile.vercel.app/api/github-stats?username=LuciNyan&screen_effect=false&background=linear-gradient(to%20bottom%20right%2C%20%2374dcc4%2C%20%234597e9)">
  <source media="(prefers-color-scheme: dark)" srcset="https://pixel-profile.vercel.app/api/github-stats?username=LuciNyan&screen_effect=true&background=linear-gradient(to%20bottom%20right%2C%20%235580eb%2C%20%232aeeff)">
  <img alt="github stats" src="https://pixel-profile.vercel.app/api/github-stats?username=LuciNyan&screen_effect=false&background=linear-gradient(to%20bottom%20right%2C%20%2374dcc4%2C%20%234597e9)">
</picture>

Here is a ready-made example configuration you can reference if you need inspiration for your own config.

Documentation

Github Stats Card Options

Name Description Default value
background Set background color/image. Supports a subset of CSS background property values #434343
color Set text color to any valid CSS color value white
include_all_commits Count all commits false
pixelate_avatar Apply pixelation to avatar true
screen_effect Enable curved screen effect false
show_avatar Display avatar true
show_rank Display rank value true
show_total_stars Display total stars earned true
username GitHub username ''

Contribute

The layout in this project is entirely done with JSX, so developing it is almost no different than a normal React project. This means anyone can easily create new cards with very little effort. If you have any ideas, feel free to contribute them here! ❤️

TODO

  • [x] Github stats card.
  • [ ] Github repo card.
  • [ ] Leetcode stats card.

Author

 

Readme

Keywords

none

Package Sidebar

Install

npm i pixel-profile

Weekly Downloads

1

Version

0.1.1

License

MIT

Unpacked Size

1.45 MB

Total Files

32

Last publish

Collaborators

  • lucinyan