Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/gurusabarish/hugo-profile/llms.txt

Use this file to discover all available pages before exploring further.

Hugo Profile is an open-source Hugo theme designed for developers and creatives who want a beautiful, fast personal portfolio and blog. It ships with pre-built sections for your hero intro, work experience, education, projects, achievements, and contact form — all configurable through a single hugo.yaml file.

Quick Start

Get your Hugo Profile site running in under 5 minutes with the example site template.

Installation

Install as a Git clone or submodule and configure the theme for your project.

Configuration

Explore every hugo.yaml parameter — colors, fonts, navbar, and more.

Sections

Configure each homepage section: Hero, About, Experience, Projects, and more.

​
What’s Included

Hugo Profile provides a complete set of features out of the box:

Responsive Layout

Mobile-first design that looks great on every screen size.

Light / Dark Mode

Built-in theme toggle with auto detection from the OS.

i18n Support

Multilingual support with English, Spanish, and French included.

Blog

Integrated blog with reading time, scroll progress, tags, and social share.

Image Gallery

Full-screen gallery with viewer.js lightbox integration.

Contact Form

FormSpree-powered contact form — no server required.

​
Get Started in 4 Steps

1

Create a Hugo site

hugo new site my-portfolio --format="yaml"
2

Add the theme

cd my-portfolio
git init
git submodule add https://github.com/gurusabarish/hugo-profile.git themes/hugo-profile
3

Copy the example config

cp -f themes/hugo-profile/exampleSite/hugo.yaml ./hugo.yaml
4

Start the dev server

hugo server
Open http://localhost:1313 to see your portfolio.
Copy the example content and static assets for a complete starting point: rsync -av themes/hugo-profile/exampleSite/static/ ./static/ && rsync -av themes/hugo-profile/exampleSite/content/ ./content/

​
Explore the Docs

Hero Section

Set up your name, subtitle, image, resume button, and social links.

Experience & Education

Document your work history and academic background.

Internationalization

Add multilingual support and customize translation strings.

Deploy to Netlify

Go live in one click with Netlify’s continuous deployment.

Build docs developers (and LLMs) love

Get started for freeTalk to us