github-readme-profile

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

github-readme-profile

(★ 55)

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

github-readme-profile Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
 <img src="https://raw.githubusercontent.com/FajarKim/github-readme-profile/master/logo.svg" alt="GitHub Readme Profile" width="120">
 <h2>GitHub Readme Profile</h2>
 🙀 Generate dynamic GitHub stats cards in SVG format. Fast, customizable, and ready to embed in your profile README.
 <a href="https://techforpalestine.org/learn-more"><img src="https://raw.githubusercontent.com/Safouene1/support-palestine-banner/master/banner-support.svg" width="100%" alt="Support Palestine"/></a>
 
 <a href="https://github.com/FajarKim/github-readme-profile/issues/new?assignees=&labels=bug&projects=&template=bug_report.yml">Report Bug</a> ·
 <a href="https://github.com/FajarKim/github-readme-profile/issues/new?assignees=&labels=enhancement&projects=&template=feature_request.yml">Request Feature</a> ·
 <a href="https://github.com/FajarKim/github-readme-profile/discussions/new?category=q-a">Ask Question</a>
 
 <a href="https://github.com/FajarKim/github-readme-profile/releases"><img src="https://custom-icon-badges.demolab.com/github/v/tag/FajarKim/github-readme-profile?label=Version&labelColor=302d41&color=f2cdcd&logoColor=d9e0ee&logo=tag&style=for-the-badge" alt="Version"></a>
 <a href="https://www.codefactor.io/repository/github/fajarkim/github-readme-profile"><img src="https://img.shields.io/codefactor/grade/github/FajarKim/github-readme-profile?label=CodeFactor&labelColor=302d41&color=8bd5ca&logoColor=d9e0ee&logo=codefactor&style=for-the-badge" alt="Code Quality"></a>
 <a href="https://github.com/FajarKim/github-readme-profile/issues"><img src="https://custom-icon-badges.demolab.com/github/issues/FajarKim/github-readme-profile?label=Issues&labelColor=302d41&color=f5a97f&logoColor=d9e0ee&logo=issue&style=for-the-badge" alt="Issues"></a>
 <a href="https://github.com/FajarKim/github-readme-profile/pull"><img src="https://custom-icon-badges.demolab.com/github/issues-pr/FajarKim/github-readme-profile?label=Pull%20requests&labelColor=302d41&color=ddb6f2&logoColor=d9e0ee&logo=git-pull-request&style=for-the-badge" alt="Pull Requests"></a>
 <a href="https://github.com/FajarKim/github-readme-profile/graphs/contributors"><img src="https://custom-icon-badges.demolab.com/github/contributors/FajarKim/github-readme-profile?label=Contributors&labelColor=302d41&color=c9cbff&logoColor=d9e0ee&logo=people&style=for-the-badge" alt="Contributors"></a>
 <a href="https://chat.whatsapp.com/DM6WaaTQ4IJ3VOe2ly6KJD"><img src="https://img.shields.io/badge/Join%20To%20Community-blue?style=for-the-badge&logo=whatsapp&color=302d41&logoColor=a6da95" alt="Join Community"></a>
</div>

## Table of Contents
- [Getting Started](#getting-started)
  - [Basic Usage](#basic-usage)
  - [Themes](#themes)
  - [Customization](#customization)
- [Advanced Usage](#advanced-usage)
  - [Gradient Backgrounds](#gradient-backgrounds)
  - [Transparent Theme & Alpha Channel](#transparent-theme--alpha-channel)
  - [GitHub Theme Context](#github-theme-context)
  - [Hiding Individual Stats](#hiding-individual-stats)
  - [Showing Additional Stats](#showing-additional-stats)
  - [Available Locales](#available-locales)
- [License](#license)
- [Deploy on Vercel](#deploy-on-vercel)
- [Credits](#credits)
- [Donate](#donate)
- [Contributions](#contributions)

## 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.

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

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

### 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.

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

<details>
 <summary>Show Example</summary>
 <a href="https://github.com/FajarKim/github-readme-profile"><img src="https://github-readme-profile-theta.vercel.app/api?username=FajarKim&theme=dark" alt="GitHub Stats"></a>
</details>

#### 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/README.md).

[default]: https://github-readme-profile-theta.vercel.app/api?username=FajarKim&theme=default
[transparent]: https://github-readme-profile-theta.vercel.app/api?username=FajarKim&theme=transparent
[dark]: https://github-readme-profile-theta.vercel.app/api?username=FajarKim&theme=dark
[highcontrast]: https://github-readme-profile-theta.vercel.app/api?username=FajarKim&theme=highcontrast

If you would like to contribute a new theme, please see our [contribution guidelines](./CONTRIBUTING.md#-themes-contribution).

### 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.

<table>
 <tr>
 <td>Name</td>
 <td>Description</td>
 <td>Type</td>
 <td>Default value</td>
 </tr>
 <tr>
 <td><code>title_color</code></td>
 <td>Defines the color of the card title.</td>
 <td><code>string</code> (hex color)</td>
 <td><code>2f80ed</code></td>
 </tr>
 <tr>
 <td><code>text_color</code></td>
 <td>Sets the color for all body text inside the card, including stat labels and numbers.</td>
 <td><code>string</code> (hex color)</td>
 <td><code>434d58</code></td>
 </tr>
 <tr>
 <td><code>icon_color</code></td>
 <td>Controls the color of the icons displayed next to each stat.</td>
 <td><code>string</code> (hex color)</td>
 <td><code>4c71f2</code></td>
 </tr>
 <tr>
 <td><code>border_color</code></td>
 <td>Specifies the color of the card border. This parameter is ignored if <code>hide_border</code> is set to <code>true</code>.</td>
 <td><code>string</code> (hex color)</td>
 <td><code>e4e2e2</code></td>
 </tr>
 <tr>
 <td><code>bg_color</code></td>
 <td>Background color of the card. Can be a solid hex color or a gradient defined as angle,start,end (e.g., <code>30,e96443,904e95</code>).</td>
 <td><code>string</code> (hex color or gradient)</td>
 <td><code>fffefe</code></td>
 </tr>
 <tr>
 <td><code>stroke_color</code></td>
 <td>Determines the color of the border around the profile image. Does not apply when <code>hide_stroke</code> is enabled.</td>
 <td><code>string</code> (hex color)</td>
 <td><code>e4e2e2</code> or <code>border_color</code> value</td>
 </tr>
 <tr>
 <td><code>username_color</code></td>
 <td>Color for the username text displayed under the photo profile.</td>
 <td><code>string</code> (hex color)</td>
 <td><code>434d58</code> or <code>text_color</code> value</td>
 </tr>
 <tr>
 <td><code>theme</code></td>
 <td>Name of a pre-defined theme. Overrides individual color parameters if set. Choose from <a href="/themes">all available themes</a>.</td>
 <td><code>enum</code></td>
 <td><code>default</code></td>
 </tr>
 <tr>
 <td><code>title</code></td>
 <td>Custom title text for the card. Must be URL-encoded (use a tool like <a href="https://www.urlencoder.org/" target="_blank">URL Encoder</a>).</td>
 <td><code>string</code></td>
 <td><code>null</code></td>
 </tr>
 <tr>
 <td><code>locale</code></td>
 <td>Sets the language of the card text. Full list of available locales can be found <a href="/i18n/README.md">here</a>.</td>
 <td><code>enum</code></td>
 <td><code>en</code></td>
 </tr>
 <tr>
 <td><code>border_width</code></td>
 <td>Explicitly sets the width of the card border in pixels.</td>
 <td><code>number</code></td>
 <td><code>1</code></td>
 </tr>
 <tr>
 <td><code>border_radius</code></td>
 <td>Controls the rounding of the card corners, measured in pixels.</td>
 <td><code>number</code></td>
 <td><code>4.5</code></td>
 </tr>
 <tr>
 <td><code>hide</code></td>
 <td>Comma-separated list of stats to hide. Options: <code>repos</code>, <code>stars</code>, <code>forks</code>, <code>commits</code>, <code>prs</code>, <code>prs_merged</code>, <code>issues</code>, <code>contributed</code>.</td>
 <td><code>string</code> (comma-separated values)</td>
 <td><code>null</code></td>
 </tr>
 <tr>
 <td><code>show</code></td>
 <td>Comma-separated list of additional stats to show. Options: <code>reviews</code>, <code>issues_closed</code>, <code>discussions_started</code>, <code>discussions_answered</code>.</td>
 <td><code>string</code> (comma-separated values)</td>
 <td><code>null</code></td>
 </tr>
 <tr>
 <td><code>format</code></td>
 <td>Output format of the card. Available options: <code>svg</code> (default), <code>png</code>, <code>json</code>, <code>xml</code>.</td>
 <td><code>enum</code></td>
 <td><code>svg</code></td>
 </tr>
 <tr>
 <td><code>disabled_animations</code></td>
 <td>If set to <code>true</code>, disables all CSS animations.</td>
 <td><code>boolean</code></td>
 <td><code>false</code></td>
 </tr>
 <tr>
 <td><code>hide_border</code></td>
 <td>Removes the outer border of the card when set to <code>true</code>.</td>
 <td><code>boolean</code></td>
 <td><code>false</code></td>
 </tr>
 <tr>
 <td><code>hide_stroke</code></td>
 <td>Removes the stroke around the profile image when set to <code>true</code>.</td>
 <td><code>boolean</code></td>
 <td><code>false</code></td>
 </tr>
 <tr>
 <td><code>revert</code></td>
 <td>Flips the layout: the stats column moves to the left, and the profile image moves to the right.</td>
 <td><code>boolean</code></td>
 <td><code>false</code></td>
 </tr>
 <tr>
 <td><code>photo_quality</code></td>
 <td>Quality of the profile image, expressed as a percentage (1–100). Lower values reduce file size but may decrease sharpness.</td>
 <td><code>number</code> (percentage)</td>
 <td><code>15</code></td>
 </tr>
 <tr>
 <td><code>photo_resize</code></td>
 <td>Resizes the profile image to the specified width in pixels. Minimum allowed value is 10px.</td>
 <td><code>number</code> (pixels)</td>
 <td><code>150</code></td>
 </tr>
</table>

## 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:

```markdown
![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.

```markdown
![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.

```markdown
![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.

```markdown
[![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)
```

<details>
 <summary>Show Example</summary>
 <a href="https://github.com/FajarKim/github-readme-profile#gh-dark-mode-only"><img src="https://github-readme-profile-theta.vercel.app/api?username=FajarKim&theme=dark#gh-dark-mode-only" alt="GitHub Stats - Dark"></a>
 <a href="https://github.com/FajarKim/github-readme-profile#gh-light-mode-only"><img src="https://github-readme-profile-theta.vercel.app/api?username=FajarKim&theme=default#gh-light-mode-only" alt="GitHub Stats - Light"></a>
</details>

### 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.

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

<details>
 <summary>Show Example</summary>
 <a href="https://github.com/FajarKim/github-readme-profile"><img src="https://github-readme-profile-beta.vercel.app/api?username=FajarKim&hide=repos,forks,prs_merged" alt="GitHub Stats"></a>
</details>

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.

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

<details>
 <summary>Show Example</summary>
 <a href="https://github.com/FajarKim/github-readme-profile"><img src="https://github-readme-profile-beta.vercel.app/api?username=FajarKim&show=reviews,issues_closed,discussions_started,discussions_answered" alt="GitHub Stats"></a>
</details>

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`](./i18n/README.md).

<table>
 <tr>
 <td>Code</td>
 <td>Locale</td>
 </tr>
 <tr>
 <td><code>en</code></td>
 <td>English</td>
 </tr>
 <tr>
 <td><code>ar</code></td>
 <td>Arabic (العربية)</td>
 </tr>
 <tr>
 <td><code>fr</code></td>
 <td>French (Français)</td>
 </tr>
 <tr>
 <td><code>id</code></td>
 <td>Indonesian (Bahasa Indonesia)</td>
 </tr>
 <tr>
 <td><code>ja</code></td>
 <td>Japanese (日本語)</td>
 </tr>
 <tr>
 <td><code>ko</code></td>
 <td>Korean (한국어)</td>
 </tr>
</table>

If your language is missing, you can contribute a new translation by following the [guidelines](./CONTRIBUTING.md#%EF%B8%8F-translations-contribution).

```markdown
![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`](./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](https://vercel.com) using your GitHub account.
2. **Fork** this repository to your GitHub account.
3. **Create a personal access token** from [GitHub Settings](https://github.com/settings/tokens/new). 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](https://raw.githubusercontent.com/FajarKim/FajarKim/master/images/deploy-on-vercel.svg)](https://vercel.com/import/project?template=https://github.com/FajarKim/github-readme-profile)

## Credits
This project is a fork of [tuhinpal/readme-stats-github](https://github.com/tuhinpal/readme-stats-github). Many design ideas and additional features were inspired by [anuraghazra/github-readme-stats](https://github.com/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](./CONTRIBUTING.md) to get started.

[![StandWithPalestine](https://raw.githubusercontent.com/Safouene1/support-palestine-banner/master/StandWithPalestine.svg)](https://techforpalestine.org/learn-more)

github-readme-profile

github-readme-profile Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

github-readme-profile

github-readme-profile Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README