Showcase your LeetCode badges on your Github README page π€©
β¨ View Demo
Β·
π Report Bug
Β·
ππ½ Request Feature
Add the following line to your Github README.md (or HTML) page and replace {your-leetcode-username}
<img src="https://leetcode-badge-showcase.vercel.app/api?username={your-leetcode-username}" alt="LeetCode Badges" />Or even this way

By default, all badges are static. To animate your badges in the showcase, add the parameter animated to the url and set its value to true:
<img src="https://leetcode-badge-showcase.vercel.app/api?username={your-leetcode-username}&animated=true" alt="LeetCode Badges" />Want to spice up the look and feel of your badge showcase? You can choose your favorite among 16 different themes!
Simply add the theme parameter to the url like so:
<img src="https://leetcode-badge-showcase.vercel.app/api?username={your-leetcode-username}&theme={your-theme}" alt="LeetCode Badges" />light |
dark |
github-dark |
monokai |
tokyonight |
nightowl |
onedark |
shades-of-purple |
dracula |
cobalt2 |
sky |
beach |
purple-gang |
mint |
leafy |
black |
transparent |
Wanna only show a specific set of badges ? Add a filter parameter like so :
<img src="https://leetcode-badge-showcase.vercel.app/api?username={your-leetcode-username}&filter={your-filter}" alt="LeetCode Badges" />| Filter | Example |
|---|---|
Competitive Badges: comp |
|
Study Plan: study |
|
Annual Badges: annual |
|
Submission Badges: submission |
|
Daily Challenge: daily |
Tip
Want to hide the border? add the parameter border to the url and set its value to no-border:
Want to hide your username from the card header?
Add the parameter anon to the url and set its value to true.
When enabled, the card header will show "LeetCode Badges" instead of "{username} LeetCode Badges".
If you have a lot of badges and want a smaller card, you can limit the total number of badges displayed to the latest x badges earned.
Add the parameter limit to the url like so:
<img src="https://leetcode-badge-showcase.vercel.app/api?username={your-leetcode-username}&limit=10" alt="LeetCode Badges" />You can combine it with other parameters (e.g. filter + animated):

- Make sure you have Node.js installed
- Clone the repository
- Run npm i in the root directory
- Run npm run dev to make sure everything's working fine
- Replace BASEURL in utils/config.ts to the deployment url of your choice
- Deploy to Vercel with the same deployment url
- Head over to https://{your-vercel-deployment-url}/api?username={your-leetcode-username} to view the results
- Oh, and make sure to update the links in your README file as well :P
If you wanna add your custom theme or suggest enhancements, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request