npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@fajarkim/github-readme-profile

v1.1.3

Published

🙀 Generate dynamic GitHub stats cards in SVG format. Fast, customizable, and ready to embed in your profile README.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

fajarkimfajarkim

Keywords

github-readme-statsgithub-statsgithub-readme-profilegithub-profile-stats

Readme

Table of Contents

Getting Started

Basic Usage

To display your GitHub stats in your profile README, simply copy and paste the following Markdown snippet. Replace FajarKim with your own GitHub username. The card will automatically fetch your latest public statistics and render them as a clean SVG image.

[![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim)](https://github.com/FajarKim/github-readme-profile)

GitHub Stats

Themes

The appearance of the card can be changed instantly by selecting one of the built-in themes. Themes control the color palette for backgrounds, text, icons, and borders. To apply a theme, add the &theme=THEME_NAME parameter to the image URL.

![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&theme=dark)

Available Built-in Themes

The project includes several pre-defined themes. You can see a preview of each below. For a complete list, refer to themes/README.md.

| Themes | Preview | | :------------------: | :-------------------------: | | default | image | | transparent | image | | dark | image | | highcontrast | image |

If you would like to contribute a new theme, please see our contribution guidelines.

Customization

Beyond the built-in themes, you have fine-grained control over every visual aspect of the card using URL parameters. Each parameter is optional and can be combined freely.

Options

The following table lists all available customization parameters, their descriptions, data types, and default values.

Advanced Usage

Gradient Backgrounds

You can create a smooth gradient background by using the bg_color parameter with the format angle,start,end. The angle is in degrees (0–360), and the colors are given as hex codes without the #. For example:

![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&bg_color=30,e96443,904e95&title_color=fff&text_color=fff&icon_color=fff)

Transparent Theme & Alpha Channel

The transparent theme removes the background entirely, making the card blend with any page background. This is especially useful if you want to embed the card in a GitHub README without a white box.

![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&theme=transparent)

You can also achieve a transparent background with any theme by setting bg_color to a fully transparent hex code (e.g., bg_color=00000000). This leaves the theme’s other colors intact.

![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&bg_color=00000000)

GitHub Theme Context

GitHub allows you to specify different images for light and dark themes using the #gh-dark-mode-only and #gh-light-mode-only tags. This lets you serve a card that automatically adapts to the viewer’s theme preference.

[![GitHub Stats - Dark](https://gh-readme-profile.vercel.app/api?username=FajarKim&theme=dark#gh-dark-mode-only)](https://github.com/FajarKim/github-readme-profile#gh-dark-mode-only)
[![GitHub Stats - Light](https://gh-readme-profile.vercel.app/api?username=FajarKim&theme=default#gh-light-mode-only)](https://github.com/FajarKim/github-readme-profile#gh-light-mode-only)

Hiding Individual Stats

If you want to keep the card compact or focus on specific metrics, you can hide certain stats using the hide parameter. The value is a comma-separated list without spaces.

![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&hide=repos,forks,prs_merged)

Available values for hide: repos, stars, forks, commits, prs, prs_merged, issues, contributed.

Showing Additional Stats

Beyond the default stats, you can enable extra metrics like code reviews, closed issues, or discussions using the show parameter.

![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&show=reviews,issues_closed,discussions_started,discussions_answered)

Available values for show: reviews, issues_closed, discussions_started, discussions_answered.

Available Locales

The card can display text in multiple languages. Use the locale parameter to change the language. Below are some of the supported locales; for a complete list, see i18n/README.md.

If your language is missing, you can contribute a new translation by following the guidelines.

![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&locale=id)

License

This project is open-source and distributed under the MIT License. You are free to use, modify, and distribute it, subject to the terms of the license. For more details, see the LICENSE file.

Deploy on Vercel

You can host your own instance of the GitHub Readme Profile on Vercel. This gives you full control over the endpoint and allows you to customize the behavior or add new features.

  1. Sign up / log in at vercel.com using your GitHub account.
  2. Fork this repository to your GitHub account.
  3. Create a personal access token from GitHub Settings. Enable the repo and user permissions. This token allows the API to fetch your private and public repository data.
  4. Import the project in Vercel:
    • Click “Add New…” → “Project”.
    • Import your forked repository.
    • Add an environment variable named GH_TOKEN with your personal access token as its value.
  5. Deploy – Vercel will automatically build and deploy your instance. Once finished, you will get a unique URL (e.g., https://your-project.vercel.app) that you can use in place of gh-readme-profile.vercel.app.

Deploy

Credits

This project is a fork of tuhinpal/readme-stats-github. Many design ideas and additional features were inspired by anuraghazra/github-readme-stats. We thank the original authors and all contributors who have helped improve this tool.

Donate

If this project has been helpful to you, please consider supporting humanitarian causes instead of donating to the author. Every contribution, no matter how small, can make a real difference.

Alternatively, you can star this repository and share it with others. That helps the project gain visibility and motivates further development.

Contributions

Contributions of all kinds are welcome! Whether you want to fix a bug, add a new theme, improve translations, or suggest a feature, please read our contribution guidelines to get started.

StandWithPalestine