Skip to Content.

GitHub Banner Generator

README header banners for a repository or your GitHub profile, in dark and light versions that switch with each visitor's theme, plus a social preview card.

Fills the fields, accent and icon from GitHub's public API.

Self-contained SVGs: fonts and icon are embedded, so they play in a README. Visitors who turn off motion see the finished frame.

Icon or avatar

PNG, SVG, JPG or WebP. Stays in your browser.

Retro 80s, Synthwave and Pixel Arcade keep their own palettes and fonts.

GitHub dark theme
GitHub light theme
1280 × 640, for the repository's social preview

Both README headers in art/, dark and light social cards, and the HTML. Animated SVG headers in art/, still PNG social cards (GitHub needs PNG there), and the HTML.

README HTML

  1. 1. Unzip into your repository

    Put the art/ folder at the root. A profile README lives in the repository named after your username.

  2. 2. Paste the HTML into README.md

    Put it at the top. The prefers-color-scheme source shows the dark header to dark-theme visitors and the light one to everyone else.

  3. 3. Set the social preview

    In the repository's Settings, under General, upload a social card as the Social preview so shared links show your banner.

Banners render in your browser. Import talks to GitHub's public API directly, and uploaded icons never leave your device.