github-readme-profile 1.0.8-beta.1
Install from the command line:
Learn more about npm packages
$ npm install @fajarkim/github-readme-profile@1.0.8-beta.1
Install via package.json:
"@fajarkim/github-readme-profile": "1.0.8-beta.1"
About this version
Copy-paste this into your markdown content, and that is it. Simple!
Change the ?username=
value to your GitHub username.
[![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim)](https://github.com/FajarKim/github-readme-profile)
With inbuilt themes, you can customize the look of the card without doing any manual customization.
Use &theme=THEME_NAME
parameter like so:
![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&theme=dark)
GitHub Readme Profile comes with several built-in themes (e.g. transparent
, dark
, highcontarst
).
Themes | Preview |
---|---|
default |
|
transparent |
|
dark |
|
highcontrast |
You can look at a preview for all available themes. You can also contribute new themes if you like, contributing guidelines can be found here.
You can customize the appearance of all your cards however you wish with URL parameters.
Name |
Description |
Type |
Default value |
|
Card's title color. |
string (hex color) |
|
|
Body text color. |
string (hex color) |
|
|
Icons color. |
string (hex color) |
|
|
Card's border color. Does not apply when |
string (hex color) |
|
|
Card's background color. |
string (hex color or a gradient in the form of angle,start,end) |
|
|
Profile image border color. Does not apply when |
string (hex color) |
|
|
Username text color. |
string (hex color) |
|
|
Name of the theme, choose from all available themes. |
enum |
|
|
Sets the language in the card, you can check full list of available locales here. |
enum |
|
|
Sets the border's width manually. |
number |
|
|
Corner rounding on the card. |
number |
|
|
Hides the specified items from stats. |
string (comma-separated values) |
|
|
Shows additional items on stats card. |
string (comma-separated values) |
|
|
Output format card option (i.e. |
enum |
|
|
Disables all animations in the card. |
boolean |
|
|
Hides the card's border. |
boolean |
|
|
Hides the image's profile stroke in the card. |
boolean |
|
We have included a transparent
theme that has a transparent background. This theme is optimized to look good on GitHub's dark and light default themes. You can enable this theme using the &theme=transparent
parameter like so:
![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&theme=transparent)
You can use the bg_color
parameter to make any of the available themes transparent. This is done by setting the bg_color
to a color with a transparent alpha channel (i.e. bg_color=00000000
):
![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&bg_color=00000000)
You can use GitHub's theme context tags to switch the theme based on the user GitHub theme automatically. This is done by appending #gh-dark-mode-only
or #gh-light-mode-only
to the end of an image URL. This tag will define whether the image specified in the markdown is only shown to viewers using a light or a dark GitHub theme:
[![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)
You can use the bg_color
parameter to make gradient color. This is done by setting the bg_color
with format angle,start,end (comma-separated value).
![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)
You can pass a query parameter &hide=
to hide any specific stats with comma-separated values.
Options:
&hide=repos,stars,forks,commits,prs,prs_merged,issues, contributed
![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&hide=repos,forks,prs_merged)
You can pass a query parameter &show=
to show any specific additional stats with comma-separated values
Options:
&show=reviews,issues_closed,discussions_started,discussions_answered
![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&show=reviews,issues_closed,discussions_started,discussions_answered)
Code |
Locale |
|
English |
|
Arabic (العربية) |
|
French (Français) |
|
Indonesian (Bahasa Indonesia) |
|
Japanese (日本語) |
|
Korean (한국어) |
See more available locale. The locale code added to file should be a 2-letter abbreviation from ISO 639-1 or a 4-letter code with a language and country code (eg. id
or pt-BR
). Anything appearing in the list should be fine. You can also contribute new translations if you like, contributing guidelines can be found here.
![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&locale=id)
GitHub Readme Profile is released under the MIT license, which grants the following permissions:
- Commercial use
- Modification
- Distribution
- Private use
For more convoluted language, see the LICENSE.
Step-by-step guide on setting up your own Vercel instance.
- Go to vercel.com.
- Click on
Log In
. - Sign in with GitHub by pressing
Continue with GitHub
. - Sign in to GitHub and allow access to all repositories if prompted.
- Fork this repository.
- Go back to your Vercel dashboard.
- To import a project, click the
Add New...
or+
button and select theProject
option. - Click the Continue with GitHub button, search for the required Git Repository and import it by clicking the
Import
button. Alternatively, you can import a Third-Party Git Repository using theImport Third-Party Git Repository
link at the bottom of the page. - Create a personal access token (PAT) here and enable the
repo
anduser
permissions (this allows access to see private repo and user stats). - Add the PAT as an environment variable named
GH_TOKEN
. - In build and output settings, you set install command toggle and add command
npm install typescript
. - Click deploy, and you're good to go. See your domains to use the API!
This repository contains forked from tuhinpal/readme-stats-github and inspired from anuraghazra/github-readme-stats.
Love the project? Please consider donating to help it improve!
Are you considering supporting the project by donating to me? Please DO NOT!!
Please visit this link and make a small donation to help the people in need. A small donation goes a long way. ❤️
Contributions are welcome!
Specially thanks ❤️ for contributors bellow:
Want to contribute? Please note our contribution guidelines here.
Made with ❤️ and TypeScript
Copyright © 2023 Rangga Fajar Oktariansyah
Details
- github-readme-profile
- FajarKim
- about 1 year ago
- MIT
- 18 dependencies
Assets
- github-readme-profile-1.0.8-beta.1.tgz
Download activity
- Total downloads 0
- Last 30 days 0
- Last week 0
- Today 0