transitive-bullshit / pixel-profile

Generate a pixel art style profile card from your GitHub data!

Home Page:https://pixel-profile.vercel.app

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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>

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
username GitHub username ''
show_rank Display rank value true
include_all_commits Count all commits false
screen_effect Enable curved screen effect false
show_avatar Display avatar true
pixelate_avatar Apply pixelation to avatar true
color Set text color to any valid CSS color value white
background Set background color/image. Supports a subset of CSS background property values #434343

Deploy on your own

On Vercel

The GitHub API has a rate limit of 5k requests per hour. So my https://pixel-profile.vercel.app/api setup could potentially hit that cap. By self-hosting it on Vercel, you eliminate that concern. Simply click "Deploy" to begin seamlessly hosting your own instance!

Deploy to Vercel

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

  • Github stats card.
  • READEME: how to deploy on Vercel.
  • Github repo card.
  • Leetcode stats card.

Author

 

About

Generate a pixel art style profile card from your GitHub data!

https://pixel-profile.vercel.app

License:MIT License


Languages

Language:TypeScript 99.8%Language:Shell 0.2%