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

Credit

I spent a non-trivial amount of effort building this template. It’s always disheartening whenever I find that someone use this template without giving me credit. Please, give me proper credit in footer.

Demo

• Live demo V1
• Live demo V2
• Live demo V3 (latest)
• Github pages demo

Requirements

• Hugo Version 0.68.0 or higher

How to use this template

• Hugo theme format
• Local Development
• Direct deployment using netlify
• Direct deployment using Github Pages and action

Hugo theme format

• Install Hugo and create a site using hugo new site my-site -f=yaml
• Clone this repo inside your themes folder and create config.yaml (I am not much aware about toml. So, I am using yaml format.) inside root folder and use one of these v1config, v2config, v3config as base template.

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

• You should have the mentioned (inside the config file) images in static folder to use them.

Local Development

• Install hugo and just clone this repo

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

• Now create config.yaml file in your root folder and use one of these v1config, v2config, v3config as base template.
• Run your site using hugo serve commend

Direct deployment using netlify

• Fork this repo or create new repo using use this template button and connect repo to netlify.
• You can customize the config file, content and everything inside website folder. Netlify will automatically deploy your changes every time you modify the repo.

What is netlify? An intuitive Git-based workflow and powerful serverless platform to build, deploy, and collaborate on web apps

Direct deployment using Github Pages and action

• Fork this repo or create new repo using use this template button. Github action will generate all files and push to demo branch. Now, you have to connect your github pages to that demo branch. No need to create demo branch. Github action will take care of it
• You can customize the config file, content and everything inside website folder. Github action will automatically deploy your changes to demo branch every time you modify the repo.

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 commend.

Issues

If you have a question, please open an issue 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

🤝 Support

Give a ⭐️ if you like this project!

See Also

• Academic
• Gokarna
• Hugo Initio
• Ink
• Iris