Notrack

Notrack is a libre Hugo theme for personal webpages whose core function is to build a fully self-hosted site that never depends on third-party services or tracking.

What is Notrack?

Notrack is a minimal, original Hugo theme focused on self-sufficiency and decentralization, created by gevhaz. It runs on the extended edition of Hugo (v0.115.4+) and outputs static HTML pages. The theme takes no external requests by default: all fonts, icons, and JavaScript are bundled in the theme folder. Input is standard Hugo content files (markdown with front matter), and output is a complete personal website that can include a home page, blog, gallery, resume, tags, categories, and an archive.

Key Features

• No third-party resources — The theme does not load anything from external CDNs; it bundles GNU FreeFont and Mononoki fonts and Font Awesome icons directly in the theme.
• Custom shortcodes — Notrack adds shortcodes for contact-box, social, gallery-category, gallery-photo, gallery-modal, gallery-script, image, video, rawhtml, and resume components (container, resume-section, resume-entry).
• Photo galleries — Place thumbnails in static/img/thumbnails and full-size images in static/img/fullsize; gallery shortcodes render a grid with modal zoom.
• Resume layout — Resume shortcodes structure education and experience into sections, with parameters what, where, and when; markdown or HTML content is accepted inside entries.
• Social icons — 65 social icons are available via the data/notrack/social.yaml file; you set your handles under [params.social].
• Blog automation — Blog posts use Hugo's default workflow; the home page shows latest posts (configurable with nBlogLatest and blogLatestHeading), and the theme adds buttons for tags, categories, and an optional archive.
• Customizable layout — Add your own CSS in assets/css/userstyles.css, set a footer via footer in config, and control navigation via menu front matter.

Who is it for?

• Privacy-conscious individuals — Build a personal site that sends no visitor data to third-party trackers by default.
• Hugo users — Anyone already using Hugo who wants a clean, minimal theme with built-in gallery, resume, and blog features without a JavaScript framework.
• Photographers — Use the gallery shortcodes to present a portfolio of images with thumbnail navigation and lightbox viewing.

What can you do with Notrack?

• Create a homepage with an image, footer, and blog summary — Add an image with the image shortcode, set a footer in config, and show the latest posts automatically.
• Publish a blog with tags and categories — Write posts with hugo new blog/..., tag them, and Notrack generates taxonomy pages with menu buttons.
• Build a gallery page — Combine gallery-category and gallery-photo with gallery-modal and gallery-script to get a full-screen photo viewer.
• Make an About Me/contact page — Use the contact-box shortcode to show social links in a framed box with floating text.

How does Notrack work?

Set up is either top-down (clone the example site and modify) or bottom-up (start with hugo new site). Add the theme as a git submodule, configure hugo.toml with theme = 'notrack' and [params], then create content pages. The README provides step-by-step instructions for each page type, with a local preview via hugo server.

FAQ

How do I update the theme?

cd into the theme directory and run git pull.

I would like to change the CSS styling of the site

You can add your own CSS by creating a file assets/css/userstyles.css. The theme automatically picks it up.

My pages don't show up on the site

Check that you have removed draft = true, added the page to a menu, and restarted hugo server.