Github profile header generator
A header image generator for your Github profile Readme
A simple but nice header image generator for your __Github profile Readme__. You can use it for your __repo banners__ too! The project is written primarily in JavaScript, distributed under the MIT License license, first published in 2022. It has gained significant community traction with 1,286 stars and 89 forks on GitHub. Key topics include: banner-generator, github, github-banner, github-header, github-header-image.
Latest release: v2.1.0
September 12, 2025View Changelog →
<div align="center"> <img src="https://raw.githubusercontent.com/leviarista/github-profile-header-generator/main/social/repo-header-image.png"> </div>
Github Profile Header Generator
What is it?
A simple but nice header image generator for your Github profile Readme.
You can use it for your repo banners too!
How to use it?
- Create a nice github header image.
- Create your GitHub profile README following this guide.
- Upload your header to your profile repo.
- Add this line to your README:
Markdown

Examples





Features list
- Edit title and subtitle texts.
- Choose colors for text, background and borders.
- Set dimensions and padding.
- Align text and decorations.
- Change fonts.
- Set the size and radius of the border.
- Set background pattern image, its color, size and opacity.
- Add decorations.
- Upload your own decoration, octocat or profile pic.
- Toogle between Github dark and light mode.
- Download image as png.
- Choose from predefined presets or get a random one.
Tech used
Get started
npm run dev- starts dev servernpm run build- builds for productionnpm run preview- locally previews production build
Get started with Docker
bashdocker-compose up -d --build --force-recreate
Contributing
Check out our Contributing guide
Contributors
Showing top 8 contributors by commit count.
This article is auto-generated from leviarista/github-profile-header-generator via the GitHub API.Last fetched: 6/15/2026
