Spin up a sleek "link-in-bio" page on GitHub Pages in minutes—no hosting bill, no complicated build chain.
Perfect for product owners, devs, and anyone in tech who wants a home base that just works.
- Zero cost, zero fuss – GitHub Pages handles the hosting and SSL.
- One JSON file, endless customisation – update text, colours, and links without touching HTML.
- Gravatar-ready – your profile pic is always in sync.
- Pulls in your latest blog posts – drop an RSS feed in the config and you're done.
- Fully responsive – looks sharp on every device.
- Custom domain ready – add your own domain with a simple CNAME file.
- MIT-licensed – remix it, ship it, brag about it. See LICENSE.
- Fork or "Use this template"
- Edit
config.json
{ "profile": { "name": "You", "tagline": "Build. Ship. Repeat.", "gravatarEmail": "you@example.com", "bio": "A short bio about yourself and what you do." }, "social": { "x": "https://x.com/you", "linkedin": "https://linkedin.com/in/you", "email": "you@example.com" }, "links": [ { "title": "My Plugin", "url": "https://wordpress.org/plugins/awesome/" } ], "blog": { "rssFeed": "https://yourblog.com/feed/", "wordCount": 40 }, "support": { "buttonText": "Buy me coffee ☕", "url": "https://buymeacoffee.com/you" } }
- Enable GitHub Pages
Go to Settings → Pages → Source, choose main branch, and save.
Your new site will be live athttps://<username>.github.io/
.
That's it—high-five! 🎉
The core.css
file simply holds the minimum layout styles and generally speaking doesn't need to change.
The theme stylesheets are loaded dynamically via javascript. To set your default theme, simply define it in the config.json
file; e.g. "theme": "kubrik"
The "Theme Switcher" allows you to preview any theme via a query parameter in your url. Just append ?theme=bulky
to your url to see whichever theme you want.
-
Switching themes – Themes can be previewed dynamically based on a URL query parameter. To preview or share your site with a different theme, just add
?theme=bulky
,?theme=kubrik
,?theme=bright
,?theme=dark
, or?theme=minimal
to your URL, for example:https://<username>.github.io/?theme=bulky
If no
theme
parameter is present, or if the value is invalid, the minimal theme will be loaded by default.To add a new theme, simply create a new CSS file in the
styles/
folder and add its name to the theme list inmain.js
. -
Stylesheet tweaks – Edit your theme file in the
styles/
folder for colors and effects, or editcore.css
for layout tweaks. -
HTML changes – everything lives in
index.html
. Keep it minimal or go wild. -
Custom domain – add a
CNAME
file with your domain name to use your own URL.
You can optionally enable Gravatar Hovercards to show a pop-up profile card when users hover over your Gravatar image.
To enable or disable this feature, set the gravatarHovercard
option in your config.json
:
{
...
"gravatarHovercard": true
}
- Set to
true
to enable the hovercard popup on your profile image. - Set to
false
to disable it (default).
For more details and customization options, see the Gravatar Hovercards User Guide.
Have a fresh style or nifty improvement?
PRs that enhance the stylesheet, improve performance, add new themes, or overall accessibility are always welcome.
See CONTRIBUTING.md for guidelines on how to contribute.
Questions, ideas, or you just deployed your own?
Open an issue or ping me on X — I'd love to see and share your Connect page with the world.
MIT License – free to use, modify, and share. See the LICENSE file for details.