https://github.com/gurusabarish/hugo-profile

A highly customizable and mobile first Hugo template for personal portfolio and blog.
https://github.com/gurusabarish/hugo-profile

github-pages hugo hugo-template hugo-theme personal-website portfolio portfolio-template website-template

Last synced: 28 days ago
JSON representation

A highly customizable and mobile first Hugo template for personal portfolio and blog.

• Host: GitHub
• URL: https://github.com/gurusabarish/hugo-profile
• Owner: gurusabarish
• License: mit
• Created: 2020-08-16T07:19:04.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2025-02-16T10:24:48.000Z (3 months ago)
• Last Synced: 2025-04-05T19:05:48.323Z (about 1 month ago)
• Topics: github-pages, hugo, hugo-template, hugo-theme, personal-website, portfolio, portfolio-template, website-template
• Language: HTML
• Homepage: https://hugo-profile.netlify.app
• Size: 25.6 MB
• Stars: 864
• Watchers: 7
• Forks: 491
• Open Issues: 58
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Hugo Profile | [Wiki Page](https://github.com/gurusabarish/hugo-profile/wiki)

[![Twitter](https://img.shields.io/twitter/url?label=Tweet&style=social&url=https%3A%2F%2Fgithub.com%2Fgurusabarish%2Fhugo-profile)](https://twitter.com/intent/tweet?text=Wow:&url=https%3A%2F%2Fgithub.com%2Fgurusabarish%2Fhugo-profile) [![GitHub forks](https://img.shields.io/github/forks/gurusabarish/hugo-profile?style=plastic)](https://github.com/gurusabarish/hugo-profile/network) [![GitHub stars](https://img.shields.io/github/stars/gurusabarish/hugo-profile?style=plastic)](https://github.com/gurusabarish/hugo-profile/stargazers)

[![Netlify Status](https://api.netlify.com/api/v1/badges/5c1dcb34-cada-4c80-82b7-cfdbdbd7c774/deploy-status)](https://app.netlify.com/sites/hugo-profile/deploys)

![Latest Release](https://img.shields.io/github/v/release/gurusabarish/hugo-profile?include_prereleases)

![Last Commit](https://img.shields.io/github/last-commit/gurusabarish/hugo-profile)

![Open Issues](https://img.shields.io/github/issues/gurusabarish/hugo-profile?color=important)

![Open Pull Requests](https://img.shields.io/github/issues-pr/gurusabarish/hugo-profile?color=yellowgreen)

![License](https://img.shields.io/github/license/gurusabarish/hugo-profile)

A high performance and mobile first hugo template for personal portfolio and blog

- ### Example Site: [https://hugo-profile.netlify.app](https://hugo-profile.netlify.app)

# Features

- Fully Responsive

- Minimalist Design

- SEO Friendly.

- Light/Dark/auto

- Taxonomies

- [Color customization](https://github.com/gurusabarish/hugo-profile/wiki/Color-Customization)

- Analytics Support 

  - [Google Analytics](https://gohugo.io/templates/internal/#google-analytics)

- Comment Support

  - [Disqus](https://gohugo.io/content-management/comments/)

- Integration with [FormSpree](https://formspree.io/) for submitting "Contact me" form

Technology used: Bootstrap, fontawesome 

# Requirements

- Hugo Version 0.87.0 or higher

# How to use this template

- [Hugo theme](#Hugo-theme)

- [Direct deployment using netlify](#Direct-deployment-using-netlify)

[For more details](https://github.com/gurusabarish/hugo-profile/wiki)

## Hugo theme

- Install Hugo and create a site using `hugo new site my-site --format="yaml"`

- Clone this repo inside your themes folder

```

cd themes

git clone https://github.com/gurusabarish/hugo-profile.git

```

- Create config.yaml (you can use `config.toml` too) inside root folder 

- Setup the configurations in `config.yaml`. [reference](https://github.com/gurusabarish/hugo-profile/blob/master/exampleSite/config.yaml)

- You should have the mentioned (_inside the config file_) images in static folder to use them.

For more details: [Hugo's official docs](https://gohugo.io/getting-started/quick-start/), [content management](https://www.mikedane.com/static-site-generators/hugo/content-organization/)

## Direct deployment using netlify

- Fork this repo or create new repo using `use this template` button and connect repo to netlify.

- whenever you customize the files exampleSite folder, netlify will automatically deploy your changes.

For more details: [host on netlify](https://gohugo.io/hosting-and-deployment/hosting-on-netlify/), [content management](https://www.mikedane.com/static-site-generators/hugo/content-organization/)

# Deployment

Run `hugo`. It will generate a folder called public. You can use the files inside public folder for deployment. You should delete the public folder for each time when you are using `hugo` command.

# Issues

If you have a question, please [open an issue](https://github.com/gurusabarish/hugo-profile/issues) for help and to help those who come after you. The more information you can provide, the better!

# Contributing

Contributions, issues, and feature requests are welcome! For major changes, please open an issue first to discuss what you would like to change.

# License

Licensed under [MIT](LICENSE)

# 🤝 Support

Give a ⭐️ or buy me a ~`coffee`~ tea if you like this project!