LucentLink

LucentLink is a clean, customizable, and responsive Linktree-style landing page template built as a Hugo theme with Tailwind CSS and Font Awesome, designed to manage your profile, social links, messaging guidelines, About section, and link cards entirely from a single Markdown front matter file.

What is LucentLink?

LucentLink is an open-source Hugo theme that produces a single-page link-in-bio website. It takes YAML front matter from content/_index.md as input and renders a fully styled landing page with a profile image, name, description, social icons, optional messaging etiquette tips, an optional About section, and a set of link cards. The theme runs on Hugo (Extended version 0.115.0 or higher) and is distributed via GitHub under the MIT License.

Key Features

• Profile Section — Displays a profile image, name, tagline, and social media icons, all configured through front matter fields.
• Messaging Etiquette — An optional section that publishes guidelines on how visitors should contact you, with icon and color per item.
• About Section — Optional multi-heading block to highlight professional background, current focus, and personal interests.
• Link Cards — Styled cards that combine an icon, title, description, and hyperlink; the link list is defined in the links array of front matter.
• Tailwind CSS — The entire UI is styled with Tailwind utility classes, and you can adjust the Tailwind config or add custom CSS under assets/css or static/css.
• Font Awesome — Any Font Awesome icon class can be assigned to social links, messaging items, and link cards.
• Modular Partials — Markup is split into four partials (profile, messaging, about, link-card) that you can override from your project's layouts/partials/ folder.
• Zero JavaScript Required — The page works without any custom JavaScript; only Hugo and Tailwind are needed for rendering.

Who is it for?

LucentLink is built for individuals and creators who want a self-hosted alternative to Linktree. It suits developers who prefer to manage content in Markdown and deploy via static hosting, as well as non-developers who can edit one YAML file to publish their links. Freelancers and professionals can use it to present a personal brand, share contact guidelines, and highlight current projects. It also fits open-source contributors who want a clean, MIT-licensed theme they can fork and customize.

What can you do with LucentLink?

• Personal link-in-bio: Publish a single page with your profile photo, bio, social icons, and a curated list of important links — ideal for Instagram, Twitter, or YouTube bios.
• Shared contact guidelines: Add a "Messaging Etiquette" block to tell followers how to reach you, reducing back-and-forth about response times or preferred channels.
• Project showcase: Use the About section to describe your professional background and the link cards to point to GitHub repositories, portfolios, or current work.
• Business or brand page: Replace the personal imagery with a logo and configure the same structure as a minimal landing page for a product, newsletter, or event.

How does LucentLink work?

LucentLink is a Hugo theme, so you start by creating a new Hugo site and cloning the theme into the themes/ directory. Enable the theme in your config file, then edit content/_index.md — the only content file you need — filling in the front matter fields for profile, socials, messaging, about, and links. Run hugo server -D to preview locally, and build with hugo --gc --minify for production.

Deployment options

The theme is deployable for free to Vercel or GitHub Pages. On Vercel, set the Framework Preset to Hugo, use the build command hugo --gc --minify, and set the output directory to public. For GitHub Pages, set a suitable baseURL in the config, build the site, and push the public/ folder to a gh-pages branch using git subtree.

Customization

All content is front matter–driven, so adding a link means appending to the links array; toggling sections means commenting out the messaging: or about: blocks. Layout changes are handled by editing partials or overriding them from your own project. The theme supports Font Awesome icon classes for full icon flexibility.

FAQ

Is LucentLink free?

Yes, LucentLink is released under the MIT License, so you can use, modify, and redistribute it freely, including for commercial projects.

Does LucentLink require Hugo?

Yes, LucentLink is a Hugo theme and requires Hugo Extended version 0.115.0 or higher. You also need Git to clone the theme repository.

Can I deploy LucentLink to GitHub Pages?

Yes, the documentation explains exactly how to build the site and push the public/ folder to a gh-pages branch, and it also supports Vercel deployment with the Hugo preset.

What files do I need to edit?

All content is managed in content/_index.md via YAML front matter. The theme's HTML partials live in the theme folder and can be overridden by copying them to your site's layouts/partials/.