Pixel Profile: Generate pixel art profiles from your GitHub data

🎉🎉🎉 Halid has created an awesome UI for pixel-profile, which makes it a breeze to edit our own GitHub cards!

Check it out! ✨ https://pixel-profile-generator.vercel.app

This Pixel Profile project would not have been possible without these 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.

Jubilee A truly unmatched pixel artist! ❤️

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>

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=<username>&screen_effect=true&theme=rainbow

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

If you want to include a GitHub stats card in your own README file and have it display the appropriate card for both the light and dark themes on GitHub, you can refer to the following configuration and configure your preferred theme, or fully customize elements like color, background, screen effects, etc:

<picture decoding="async" loading="lazy">
  <source media="(prefers-color-scheme: light)" srcset="https://pixel-profile.vercel.app/api/github-stats?username=<username>&theme=summer">
  <source media="(prefers-color-scheme: dark)" srcset="https://pixel-profile.vercel.app/api/github-stats?username=<username>&screen_effect=true&theme=blue_chill">
  <img alt="github stats" src="https://pixel-profile.vercel.app/api/github-stats?username=<username>&theme=summer">
</picture>

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

Below are some prebuilt themes to get started. However, cards are fully customizable by passing in background and color props. Feel free to ditch the premade themes and design unique cards by selecting your own colors and backgrounds!

https://pixel-profile.vercel.app/api/github-stats?username=<username>&theme=journey&pixelate_avatar=false

The dithering=true configuration is a standalone setting that can be applied to any theme.

https://pixel-profile.vercel.app/api/github-stats?username=<username>&theme=journey&dithering=true&hide=avatar

https://pixel-profile.vercel.app/api/github-stats?username=<username>&theme=road_trip&pixelate_avatar=false

https://pixel-profile.vercel.app/api/github-stats?username=<username>&theme=fuji&pixelate_avatar=false

https://pixel-profile.vercel.app/api/github-stats?username=<username>&theme=rainbow&pixelate_avatar=false

https://pixel-profile.vercel.app/api/github-stats?username=<username>&theme=monica

https://pixel-profile.vercel.app/api/github-stats?username=<username>&theme=summer

https://pixel-profile.vercel.app/api/github-stats?username=<username>&theme=lax

You can pass a query parameter &hide= to hide any specific stats with comma-separated values.

Options: &hide=avatar,commits,contributions,issues,prs,rank,stars

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

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, you eliminate that concern.

To use this tool to retrieve user statistics, you'll need to generate a Personal Access Token (PAT) with the proper scopes.

Click here to create a new PAT.

Under "Select scopes" check the box for "repo" and "user" like in the image below:

Copy the generated PAT for use in the config file or as an environment variable.

Once you have generated a Personal Access Token (PAT) from your GitHub account, you'll need to add it to your Vercel project configuration in order to authenticate API requests.

To add the PAT to Vercel:

In addition to Vercel, you can also deploy to other PaaS platforms (e.g. zeabur.com, heroku.com, fly.io) or hosted on your own server!

First you need to have a zeabur account.

Fork this repository and log in to Zeabur.

"Create a Project (or select an existing one)" - "Add Service" - "Git" - "Select the forked pixel-profile repository".

Don't forget to add your "Personal Access Token (PAT) " in "Variable".

Finally, go to "Networking" and generate a domain (or bind your own).

# Clone repository
git clone https://github.com/LuciNyan/pixel-profile.git

# Go to the directory to build the Docker image
cd pixel-profile
docker build -t pixel-profile .

# Create and start the container
docker run -d \
  --name pixel-profile \
  -p 3000:3000 \
  -e PAT_1=ghp_xxxxxx \ # Please change it to your "Personal Access Token (PAT) "
  -e PORT=3000 \
  --restart always \
  pixel-profile

# The service has successfully started on port 3000!

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! ❤️

Follow these 4 easy steps to get pixel-profile running on your local machine:

pnpm install

Refer to the "Creating a Personal Access Token" section above.

Use .env.example as a guide to set your environment variables.

PAT_1=xxxxxxx

pnpm start

• Github stats card.
• Github repo card.
• Leetcode stats card.

• LuciNyan