Hugo static site, targeting personal portfolios and blogs
HugoPortfolio
hugo_website — Hugo Portfolio Template
By guiquan-1
A Hugo-based personal portfolio and blog site template; the repository author used it to build a personal website and deploy it via Netlify.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Desktop homepage1 / 3
Desktop captureTop of page
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-13View source
What stands out
A quick read of the recorded project description.
Responsive layout and minimalist design, supporting light/dark/auto themes
Supports taxonomies, color customization, and Google Analytics
Integrates Disqus comments and a Formspree contact form
Can be deployed directly via Netlify; the repository uses the MIT license
Template Details
This repository is a personal website project built with Hugo, positioned as a personal portfolio and blog. The repository description states that it is a simple personal website made with a Hugo theme and deployed via Netlify, with the live example at tanguiquan.com. The README content comes from the upstream theme hugo-profile (author gurusabarish), indicating that the template targets personal portfolios and blogs, uses a responsive layout and minimalist design, and supports light/dark/auto theme switching, taxonomies, color customization, Google Analytics, Disqus comments, and a "Contact Me" form submitted through Formspree. On the technical stack, the README mentions the use of Bootstrap and FontAwesome, and requires Hugo 0.87.0 or higher. There are two usage approaches: clone it as a Hugo theme into the themes directory and configure it in config.yaml (or config.toml), or directly fork/use the template button to create a repository and then connect it to Netlify for automatic deployment. When building, run hugo to generate the public directory for deployment. Regarding licensing, the repository uses the MIT license, allowing free use, modification, commercial use, and distribution of this version of the code, but the copyright and license notice must be retained; third-party assets such as external services like Formspree, demo images, and font icons require separate verification of authorization and fees.
HugoPortfolio
Is it right for your project?
Use Cases
- Building personal portfolio and resume display pages
- Creating a personal blog with categories and comments
- Automatically deploying a static site from a Git repository via Netlify
Suitable For
- Individual developers who want to quickly build a personal website with Hugo
- Users who need a combined portfolio and blog site
- People who prefer static sites and accept the Netlify deployment workflow
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Requires Hugo 0.87.0 or higher
- 2
The repository can be cloned into the themes directory and configured in config.yaml or config.toml
- 3
Images referenced in the configuration file need to be placed in the static directory
- 4
Run hugo to generate the public directory for deployment; the old public directory should be deleted before rebuilding
- 5
The contact form depends on Formspree; you need to configure the service endpoint yourself and verify quotas and fees
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is this version of the code and does not mean that external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version of the code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- The README mentions the Formspree form service; actual submissions require configuring a service endpoint, and its usage quotas and fees need to be verified separately.
- Demo images, fonts, icons, and other third-party assets need to be checked under their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
- The contact form depends on the third-party Formspree service; you need to register and configure a service endpoint yourself, and it may be subject to its free quota and fees.
- Enabling visit statistics requires integrating the external Google Analytics service and providing the corresponding tracking identifier.
- The comment feature depends on the third-party Disqus service; you need to register and configure it yourself.
- The direct deployment approach depends on the external Netlify hosting service; you need to register an account and connect the repository yourself.
- Using this template requires Hugo 0.87.0 or higher to be installed in the local or build environment.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
Integration with [FormSpree](https://formspree.io/) for submitting "Contact me" form
Original README
- [Google Analytics](https://gohugo.io/templates/internal/#google-analytics)
Original README
- [Disqus](https://gohugo.io/content-management/comments/)
Original README
- Fork this repo or create new repo using `use this template` button and connect repo to netlify.
Original README
https://github.com/guiquan-1/hugo_website/blob/master/LICENSEhttps://github.com/guiquan-1/hugo_website/blob/master/README.md- Hugo Version 0.87.0 or higher
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-13. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 83 / 100
- Technologies
- Hugo
- Website type
- Portfolio
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2026-03-17
- Screenshot last checked
- 2026-10-13
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Hugo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Review declaration: [email protected] · 2026-10-13
Inspect the recorded source material
SHA-256: 2d43a9f54e86d5b3c90d00e7507a156ca878fe7c313f984fd37ffbd17e12ae26
2026-10-13T01:03:51.955Z
Source file / repository# Hugo Profile | [Wiki Page](https://github.com/gurusabarish/hugo-profile/wiki) [](https://twitter.com/intent/tweet?text=Wow:&url=https%3A%2F%2Fgithub.com%2Fgurusabarish%2Fhugo-profile) [](https://github.com/gurusabarish/hugo-profile/network) [](https://github.com/gurusabarish/hugo-profile/stargazers) [](https://app.netlify.com/sites/hugo-profile/deploys)      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) Template from (https://github.com/gurusabarish) ## 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. ## 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! <a href="https://www.buymeacoffee.com/gurusabarish" target="_blank" rel="noopener"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" height="40" width="145" alt="Buy Me A Coffee"></a>
Explore similar templates
Compare previews and descriptions within the same stack and category.
hugo-PaperMod
A fast, clean, responsive Hugo theme for blogs and lightweight portfolios, with three layout modes (Regular, Home-Info, Profile), automatic and manual light/dark themes, Fuse.js client-side search, multilingual support, and built-in Open Graph, Twitter Cards, and Schema.org data.
Hugo · Portfolio
Congo
Congo is a minimal Hugo content theme built on Tailwind CSS 3.0, designed for blogs, portfolios, and lightweight content sites. It offers multiple homepage layouts, customizable dark mode, multilingual support including RTL, and built-in client-side search, Mermaid, Chart.js, and KaTeX.
Hugo · Blog
toha
Toha is a Hugo theme for personal portfolios, featuring a minimalist, responsive design with configurable homepage sections such as about, experience timeline, and achievements gallery.
Hugo · Portfolio
hugo-profile
hugo-profile is a mobile-first Hugo theme for personal portfolios and blogs, with multilingual support, light/dark themes, categories and tags, Google Analytics, Disqus comments, and Formspree contact forms.
Hugo · Portfolio
hugo-theme-introduction
Introduction is a minimal Hugo theme that can be configured as a single-page site or a full site with multiple sections. Homepage sections are generated from Markdown files under content/home/, with weight sorting and optional images.
Hugo · Portfolio
hugo-theme-console
A minimalist, responsive Hugo theme inspired by the system terminal and built on Terminal CSS. It includes blog posts, photo galleries, and custom pages, with light/dark theming and style overrides via CSS variables.
Hugo · Portfolio