Choose a style, replace the example information, generate your profile art, and publish it—manually or with help from AI.
If this collection helps your profile stand out, star the repository so more developers can find it.
GitHub lets you display a special README.md on your profile. Pretty GitHub is a collection of complete profile systems for that README—not screenshots or paid downloads.
Every design includes:
- A real GitHub-rendered preview
- Editable source files and generated SVG artwork
- A step-by-step
SETUP.md - A copy-paste prompt that lets a coding AI configure it for you
- Optional live GitHub statistics and contribution data
- A GitHub Action that keeps supported data updated automatically
There are currently 4 complete designs.
- Choose a design.
- Open its preview and
SETUP.md. - Create a public GitHub repository named exactly like your username.
- Copy the contents of the selected design folder into that repository.
- Follow the manual steps—or give the included prompt to an AI coding assistant.
- Push the finished files and open your GitHub profile.
Important
Replace all example names, links, usernames, repository names, and portrait files before publishing a template as your own profile.
Use Code → Download ZIP on GitHub, or clone the collection:
git clone https://github.com/Jenesyx/pretty-github.gitCopy only the contents of one selected design folder into your profile repository—not the entire Pretty GitHub collection. Include its hidden .github folder so automatic updates work.
| # | Design | Visual direction | Best for | Setup |
|---|---|---|---|---|
| 01 | Jenesyx Terminal | Black, GitHub green, terminal UI | Hacker-style profiles and ASCII art | Guide |
| 02 | Ember Command | Crimson, orange, amber | Product builders and cinematic tech profiles | Guide |
| 03 | Paper Signal | Ivory, cobalt, coral, acid-lime | Designers and editorial portfolios | Guide |
| 04 | Aqua Launch | Deep teal, electric mint, signal blue | Animated profiles and data-rich GitHub identities | Guide |
The original profile design used by the creator of this repository. It combines a self-typing ASCII portrait, a neofetch-inspired biography card, and a live contribution heatmap.
Includes: ASCII portrait · terminal biography · contribution heatmap · daily updates
Open full preview → · Read setup guide → · View Arta’s GitHub profile →
A cinematic mission-control identity with warm orbital motion, GitHub telemetry, language bars, and featured repository transmissions.
Includes: orbital identity · live stats · language mix · four featured repositories
Open full preview → · Read setup guide →
A bright independent-magazine layout for people who want their GitHub profile to feel like a designed portfolio instead of another dark statistics dashboard.
Includes: editorial cover · live work index · language mix · featured repositories
Open full preview → · Read setup guide →
An animated blue-green flight system with a self-typing ASCII portrait, dense morphing wordmark, live contribution field, shooting spacecraft, signal cards, and language stack.
Includes: ASCII portrait · morphing wordmark · contribution field · animated spacecraft · live stats
Open full preview → · Read setup guide →
Every design is self-contained. After copying one design into your special GitHub profile repository:
- Read that design’s
SETUP.mdfrom beginning to end. - Replace the example identity and contact information.
- Replace any example portrait source with your own image.
- Install only the requirements listed by that design.
- Run its generator from the repository root.
- Preview
README.mdwithCtrl+Shift+Vin VS Code. - Push the files and run the included workflow once from the Actions tab.
GitHub shows a profile README only when the repository is public and its name exactly matches the account username.
Each setup guide contains a prompt tailored to that design. Fill in its placeholders, attach your portrait when needed, and send it to Codex, ChatGPT, Claude, or another coding assistant with the repository open.
You can also begin with this short prompt:
Set up the [DESIGN NAME] template from this repository as my GitHub profile README. Read its SETUP.md completely, ask me only for information that is truly missing, replace all example identity data and personal assets, run the documented generator, validate the generated SVGs and Markdown links, and verify the GitHub Action. Preserve the design and animations. Do not change unrelated files, and do not commit or push unless I explicitly ask.
Design-specific prompts:
The templates use regular Markdown, HTML accepted by GitHub, generated SVG files, and small Python scripts. Live data comes directly from GitHub’s public API or public contribution page.
- No subscription is required.
- No paid profile generator is required.
- Generated artwork is committed to your own repository.
- GitHub Actions can refresh live data on a schedule.
- The profile remains yours even if this collection disappears.
pretty-github/
├── Jenesyx/ # Terminal and ASCII profile
├── Ember-Command/ # Warm mission-control profile
├── Paper-Signal/ # Bright editorial profile
├── Aqua-Launch/ # Animated blue-green profile
├── CONTRIBUTING.md
├── LICENSE
└── README.md
Inside every design folder, README.md is the real preview and SETUP.md is the complete installation guide.
Yes. The previews use the same Markdown and image approach used by GitHub profile repositories. GitHub itself is the most accurate final preview.
No. The guides provide exact commands, and every design includes an AI setup prompt. Python is used only to generate the SVG artwork and live data.
Yes. Each setup guide identifies the configuration fields and palette constants. You can customize them without rebuilding the design from scratch.
Your README.md displays those files. Committing them makes the profile render reliably without depending on a paid or always-online rendering server.
Yes. Read CONTRIBUTING.md before opening a pull request. New designs must be original, self-contained, documented, and safe to publish.
Pretty GitHub is created and maintained by Arta Bidkhori—a developer, UI/UX designer, and AI automation builder based in Germany and originally from Tehran.
The Jenesyx Terminal design above is Arta’s own GitHub profile style and the starting point of this collection.
Ideas, fixes, documentation improvements, and original profile styles are welcome. See CONTRIBUTING.md for the required structure and quality checklist.
The code, generators, documentation, and reusable design templates are available under the MIT License. Example portrait and likeness assets are excluded and must be replaced before publishing your own profile.
Pick a style. Make it yours. Give your GitHub profile a real identity.
Choose a design · Visit Arta’s profile · Star this repository