Vec

Vec is a minimal, clean Hugo theme for building personal blogs and portfolio sites, offering Disqus comments, table of contents, and Formspree contact forms out of the box.

What is Vec?

Vec is a static-site theme built for Hugo, the open-source static site generator. It takes a Hugo site configuration file and Markdown content posts, and outputs a fast, pre-rendered HTML blog or portfolio site. The theme was designed by Cedric Fung and is released under the MIT license.

Key Features

• Minimal uncluttered design — focuses on readability with a clean white layout and no sidebars or widget bloat.
• Disqus comments — enabled by adding your Disqus shortname in config.toml and optionally toggling comments per-post with a front matter variable.
• Table of contents — per-post TOC can be turned on via toc: true in front matter; TOC is automatically hidden on browser widths under 920px.
• Formspree contact form — any page can enable a contact form that emails you, once an email address is set in config.toml and formspree: true is added to front matter.
• Social profile links — config.toml supports Github, Twitter, Facebook, LinkedIn, and Googleplus IDs, which are rendered as icons.
• Built-in analytics — Google Analytics tracking ID can be added to config.toml for visitor tracking.
• Example site included — the exampleSite folder provides a working config.toml, content, and static assets to copy and customize.

Who is it for?

• Bloggers — publish Markdown posts with hugo new post/post-title.md and get a clean reading experience.
• Developers — set up a personal portfolio site that pulls from a GitHub profile and shows project posts.
• Writers who want comments — integrate Disqus in minutes and enable/disable per post.

What can you do with Vec?

• Start a personal blog — clone the repo into themes, copy exampleSite content, run hugo server --buildDrafts to preview posts locally.
• Add a contact page — set formspree: true in front matter on any page and receive messages via email.
• Customize site metadata — edit Keywords, Description, and social IDs in config.toml to adapt the site for any audience.

How does Vec work?

The workflow is: install Hugo and create a project, clone the theme into the themes folder, copy exampleSite's config.toml and content/static folders into your root, then add front matter flags like comments, toc, or formspree to control per-page behavior. The site is built with hugo or hugo server.

Pricing

Vec is open source under the MIT license, so it's free to use, modify, and even redistribute with attribution.

FAQ

Is Vec free?

Yes, the theme is open sourced under the MIT license, so it costs nothing to use for personal or commercial projects.

How do I enable comments?

Set disqusShortname in config.toml, then add comments: true to any post's front matter where you want the comment thread to appear.

Can I add a table of contents to a post?

Yes, add toc: true to a post's front matter. Note that TOC is hidden when the browser width is under 920px.

How do I set up a contact form?

Put your email address in config.toml as Email, then add formspree: true to the front matter of the page where you want the form.

Does Vec support analytics?

Yes, insert your Google Analytics tracking ID into googleAnalytics in config.toml, and the theme will include the tracking code.