Bootstrap-based box-layout personal blog theme powered by Hugo
persian-hugo — Hugo Portfolio Template
By gethugothemes
Persian is a Bootstrap-based Hugo personal blog theme with a box layout, offering responsive pages, a contact form, site search, and GDPR consent as basic features.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Responsive design that adapts to different screen sizes
Built-in fuse.js site search and contact form
Supports Google Analytics, Open Graph, and Twitter Card meta tags
Bundles CSS and JS via Hugo Pipes and includes preconfigured Netlify settings
Preconfigured Sitepins headless CMS for visual content editing
Template Details
Persian is a Hugo theme maintained by Gethugothemes, positioned as a personal blog. It uses a box design layout, is built on Bootstrap, and supports responsive display across different screen sizes. The theme includes Google Analytics support, CSS and JS bundling via Hugo Pipes, preconfigured Netlify settings, a contact form, site search based on fuse.js, GDPR consent, and Open Graph and Twitter Card meta tags.
For content management, the template comes preconfigured with Sitepins, a Git-based headless CMS, allowing text, images, and configuration to be modified without directly editing code. Local development uses npm scripts to initialize the project and start the development server, and the repository provides links to full documentation.
Regarding licensing, the code is under the MIT license, permitting free use, modification, commercial use, and distribution, provided the copyright and license notice are retained when redistributed. Third-party assets such as demo images, fonts, and icons must be checked separately under their respective licenses, and external services such as domains and hosting may incur additional charges.
Is it right for your project?
Use Cases
- Building a personal blog and publishing articles
- Creating content-focused portfolio pages
- Lightweight sites that need site search and a contact form
- Static websites whose content is managed through a visual CMS
Suitable For
- Individual bloggers building static sites with Hugo
- Developers who prefer Bootstrap and a box layout
- Users who need MIT-licensed code for personal or commercial projects
- Editors who want to manage content through a Git-based CMS such as Sitepins
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
After cloning the repository, run npm run project-setup to initialize the project
- 2
Use npm run dev to start the local development server
- 3
Full documentation is available at https://docs.gethugothemes.com/persian/
- 4
Demo images are for display only; check their respective licenses before use
- 5
The code is under the MIT license; retain the copyright and license notice when redistributing
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 applies to that version's code and does not imply that external services or third-party assets are free.
Must comply with when using
- The code of this version may be used, modified, used commercially, and distributed free of charge.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full 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
- Demo images are for display only and are licensed separately; the project has no right to share these images. You must verify and obtain the appropriate authorization before use, and they cannot be used under the MIT code license.
- The template comes preconfigured with the Sitepins headless CMS; using it for visual content editing requires registering a Sitepins account and depends on that external service, which may involve additional fees or terms of service.
- Google Analytics support requires registering a Google Analytics account and configuring a tracking ID, which is an external service.
- Netlify settings are preconfigured; deploying to Netlify requires using its hosting service, which may incur fees or be subject to its terms.
- The contact form requires an external form-handling service or backend configuration to actually send and receive email; it is not a standalone out-of-the-box feature.
- Demo images, fonts, icons, and other third-party assets must 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.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
**Image license:** The images are only for demonstration purposes. They have their licenses. We don't have permission to share those images.
Original README
This template comes pre-configured with [**Sitepins**](https://sitepins.com/?aff=ghtgithub), a Git-based Headless CMS designed for seamless content management.
Original README
- 📊 Google Analytics support
Original README
- ⚙️ Netlify settings predefined
Original README
https://github.com/gethugothemes/persian-hugo/blob/main/LICENSEhttps://github.com/gethugothemes/persian-hugo/blob/main/README.md- ✉️ Contact form support
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-01. 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 · 92 / 100
- Technologies
- Hugo · HTML
- Website type
- Portfolio · Blog · Tool Site
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-07-12
- Screenshot last checked
- 2026-10-01
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.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: 2d784f30a9f56d94ba26fe28de89902337bae075080b99eb21cb78a8e0ceba52
2026-10-01T13:51:53.596Z
Source file / repository<h1 align=center> Persian Hugo</h1>
<p align=center>Persian is a personal Hugo blog theme.It has a lighting fast loading time which is a courtesy of the Hugo framework </p>
<h2 align="center"><a target="_blank" href="https://persian-hugo.vercel.app/" rel="nofollow">👀Demo</a> | <a target="_blank" href="https://pagespeed.web.dev/analysis/https-persian-hugo-vercel-app/bcemgwnape?form_factor=desktop">Page Speed (88%)🚀</a> </h2>
<p align=center>
<a href="https://github.com/gohugoio/hugo/releases/tag/v0.163.3" alt="Contributors">
<img src="https://img.shields.io/static/v1?label=min-HUGO-version&message=0.163.3&color=f00&logo=hugo" />
</a>
<a href="https://github.com/gethugothemes/persian-hugo/blob/master/LICENSE">
<img src="https://img.shields.io/github/license/gethugothemes/persian-hugo" alt="license"></a>
<img src="https://img.shields.io/github/languages/code-size/gethugothemes/persian-hugo" alt="code size">
<a href="https://github.com/gethugothemes/persian-hugo/graphs/contributors">
<img src="https://img.shields.io/github/contributors/gethugothemes/persian-hugo" alt="contributors"></a>
<a href="https://twitter.com/intent/follow?screen_name=gethugothemes">
<img src="https://img.shields.io/twitter/follow/gethugothemes?style=social&logo=twitter"
alt="follow on Twitter"></a>
</p>
---
<p align="center">
<img src="https://assets.teamosis.com/thumbs/persian.png" alt="screenshot" width="100%">
</p>
---
## 🔑Key Features
- 📊 Google Analytics support
- 🎨 CSS and JS bundle with Hugo Pipe
- 🅱️ Bootstrap
- ⚙️ Netlify settings predefined
- ✉️ Contact form support
- 🔍 Search by fuse.js
- 🔄 GDPR consent enabled
- 🚀 Google Page Speed optimized
- 🌐 Open Graph meta tag
- 🐦 Twitter Card meta tag
## 🔧Local development
```bash
# clone the repository
git clone [email protected]:gethugothemes/persian-hugo.git
# setup project
$ npm run project-setup
# Start local dev server
$ npm run dev
```
Or Check out [Full Documentation](https://docs.gethugothemes.com/persian/?ref=github).
<!-- edit with sitepins -->
## 📝 Edit Content with CMS
This template comes pre-configured with [**Sitepins**](https://sitepins.com/?aff=ghtgithub), a Git-based Headless CMS designed for seamless content management. You can update your website’s text, images, and configuration without touching a single line of code.
**How to get started:**
Click the Edit with Sitepins button below and follow the on-screen instructions to start editing your content visually.
<a target="_blank" href="https://app.sitepins.com/new/clone?name=Persian%20Hugo&repository=https://github.com/gethugothemes/persian-hugo/?aff=ghtgithub">
<img src="https://sitepins.com/button.svg" alt="Edit with Sitepins">
</a>
<!-- reporting issue -->
## 🐞Reporting Issues
We use GitHub Issues as the official bug tracker for the persian Template. Please Search [existing
issues](https://github.com/gethugothemes/persian-hugo/issues). Someone may have already reported the same problem.
If your problem or idea has not been addressed yet, feel free to [open a new
issue](https://github.com/gethugothemes/persian-hugo/issues).
## 📱Submit Your Website To Our Showcase
Are you using Persian Hugo theme? Submit it to our [showcase](https://gethugothemes.com/showcase).
Our showcase aims to demonstrate to the world what amazing websites people like you have created utilizing our Hugo themes and to show that Hugo has tremendous capabilities as a Static Site Generator.
View all the websites powered by Persian Hugo from [here](https://gethugothemes.com/showcase?theme=persian).
[Submit](https://gethugothemes.com/showcase?submit=show) your Persian Hugo powered website.
<!-- licence -->
## 📄License
Copyright © Designed by [Themefisher](https://themefisher.com) & Developed by
[Gethugothemes](https://gethugothemes.com)
**Code License:** Released under the [MIT](https://github.com/gethugothemes/persian-hugo/blob/master/LICENSE) license.
**Image license:** The images are only for demonstration purposes. They have their licenses. We don't have permission to
share those images.
<!-- resources -->
## 🙏Special Thanks
- [Bootstrap](https://getbootstrap.com)
- [Jquery](https://jquery.com)
- [Themify Icons](https://themify.me/themify-icons)
- [Fuse Js](http://fusejs.io)
- [Mark Js](https://markjs.io/)
- [Google Fonts](https://fonts.google.com/)
- [All Contributors](https://github.com/gethugothemes/persian-hugo/graphs/contributors)
## 👨💻Hire Us
Besides developing unique, blazing-fast Hugo themes, we also provide customized services. We specialize in creating affordable, high-quality static websites based on Hugo.
If you need to customize the theme or complete website development from scratch, you can hire us. **Check Our
[services](https://gethugothemes.com/services/?utm_source=persian_github&utm_medium=referral&utm_campaign=github_theme_readme)**
<!-- premium themes -->
## 💎Premium Themes By Us
| [](https://gethugothemes.com/bundle/?utm_source=persian_github&utm_medium=referral&utm_campaign=github_theme_readme) | [](https://gethugothemes.com/products/logbook/) | [](https://gethugothemes.com/products/parsa/) |
|:---:|:---:|:---:|
| **Get 68+ Premium Hugo Themes Bundle** | **Logbook** | **Parsa** |
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

LoveIt
LoveIt is a clean, elegant, and feature-rich Hugo blog theme derived from LeaveIt and KeepIt, MIT-licensed. It offers light/dark modes, responsive layout, multilingual support, and search via Lunr.js or Algolia.
Hugo · Blog

hugo-coder
hugo-coder is a minimalist Hugo blog theme maintained by luizdepra under the MIT license. It provides a clean, text-focused blog appearance, configuration documentation in the docs directory, and a complete exampleSite with hugo.toml.
Hugo · Blog

blowfish
Blowfish is a Hugo personal website and blog theme built with Tailwind CSS 4, focused on lightness, simplicity, and content-first presentation.
Hugo · Blog

hugo-paper
hugo-paper is a simple, clean, and customizable Hugo blog theme configured through config.toml or hugo.toml.
Hugo · Blog

hextra
Hextra is a Hugo theme for documentation and blog sites, built on Hugo and Tailwind CSS with design referencing Nextra.
Hugo · Documentation
