Hugo Theme Moments is a Hugo theme built for micro-blogging that turns a static site into a personal or shared space for short posts called Moments, supporting images, article links, and video embeds.
What is Hugo Theme Moments?
Hugo Theme Moments is a blog theme for the Hugo static site generator, created by FarseaSH, designed specifically for short-form content rather than long articles. It takes Markdown files with YAML front matter as input and outputs a responsive, self-hosted website that mimics a social media feed without ads or platform restrictions. The theme requires the extended version of Hugo to compile.
Key Features
- Micro-blogging focus — The theme is built entirely around short posts named Moments, with no traditional blog post layout; each Moment is a compact card.
- Responsive design — Layouts are optimized for both desktop and mobile screens, with a media-browsing experience similar to social platforms for photo galleries.
- Multi-user support — A single site can host multiple authors, each with a name, signature, and avatar defined in the front matter, making it suitable for couples, friends, or team spaces.
- Link sharing — Moments can contain a link field with link_text, enabling the display of embedded previews for WeChat articles, Zhihu posts, Bilibili videos, and NetEase Cloud Music tracks.
- Customizable front matter — Each Moment supports date, tags, note, and either a pictures array of image URLs or a link/link_text pair, giving fine control over content.
- Hugo-native workflow — New Moments are created with
hugo new moments/your_moment_name.md, and the site deploys through standard Hugo hosting methods like Hugo Deploy.
Who is it for?
- Individuals who want a personal, ad-free space outside WeChat Moments to record daily thoughts, discoveries, and ideas.
- Couples looking for a private shared micro-blog to document their relationship, as shown in the showcase example
情侣点滴. - Small teams or friend groups that need a lightweight internal update feed for sharing product updates or personal news.
- Developers comfortable with Hugo and static site hosting who want a self-contained, git-based alternative to social media.
What can you do with Hugo Theme Moments?
- Photo journaling: Post Moments with up to nine images per gallery, displayed in a social-media-style lightbox for viewing.
- Article curation: Share a link to a WeChat public account article (or other URLs) with a note and a custom link text, creating a bookmark-style post.
- Video sharing: Embed Bilibili videos directly in a Moment by pasting the player URL in the link field.
- Themed collections: Use tags to organize Moments by topic (e.g., 美食, 好文收藏, 好看的视频分享) and build a browsable archive.
How does it work?
Install the theme by cloning the repository into the themes directory of a new Hugo site, then copy the sample configuration into config.yaml. To publish a Moment, run hugo new moments/your_moment_name.md, edit the front matter with name, avatar, date, tags, and either pictures or link fields, then deploy with Hugo Deploy or any static hosting service.
FAQ
Does Hugo Theme Moments require Hugo extended?
Yes, the theme requires the extended version of Hugo because it uses features like Sass/SCSS compilation. The installation guide links to the official Hugo installation page to get extended.
Can I use Moments for a group or couple?
Yes, the theme supports multiple users — each Moment front matter includes a name, signature, and avatar, so different people can post to the same site with their own identity.
What content types can a Moment contain?
A Moment can contain a note text, tags, a date, and either a pictures array for image galleries or a link with link_text for articles/videos, plus optional name and avatar overrides.
How do I create a new Moment?
Run the Hugo command hugo new moments/your_moment_name.md in your site root. Hugo will generate a Markdown file with the Moments archetype, which you then fill in with front matter fields.
Is the theme free?
The source code is available on GitHub at github.com/FarseaSH/hugo-theme-moments with a repository star count of 180; it is an open-source Hugo theme, so it can be used freely under its license.
