Freaky

Freaky is a minimal, dark, single-page portfolio theme for Hugo, the static site generator. It builds a personal portfolio homepage from configuration and markdown content, outputting plain HTML, CSS, and JavaScript with no build tooling and no JavaScript dependencies.

What is Freaky?

Freaky is a Hugo theme that renders a single-page personal portfolio. All identity and content come from your site's hugo.toml [params] and markdown files under the content directories, so the theme ships with no hardcoded personal data. It runs on Hugo's standard template lookup system, and it was created by Sanjay Pahari (freaktopus).

Key Features

• Single-page scroll-spy layout — navigation highlights the section currently in view, with no page reloads.
• Typing animation for roles — the current_roles array is cycled in a terminal-style line, hidden automatically when empty.
• Avatar and role-card flicker — two images per slot with configurable hold times (hold_a, hold_b, plus delay for track cards).
• Four content sections — projects (with a show-more toggle), publications, articles/news, and blogs; each renders only when its directory contains pages, and empty sections are hidden from navigation.
• Backend-free contact form — animated purpose selector validates input and copies a drafted message (purpose, sender address, description) to the visitor's clipboard, exposing no email address.
• Configurable design tokens — accent, background, surface, text, muted, and border colors are overridable from [params.style].
• Optional site-views counter — bring your own endpoint returning JSON with a numeric count field; disabled by default.
• Template extension hooks — layouts/partials/hooks/head-end.html and layouts/partials/hooks/body-end.html inject custom head and body-end content.

Who is it for?

• Researchers and academics: publish a publications list alongside projects and news using front matter fields for authors, venue, and links.
• Developers and designers: present projects with logos or marks and optional external URLs in a fast static site.
• Writers and bloggers: surface articles and blog posts as summary cards linking out to where the work lives.

What can you do with Freaky?

• Independent professionals: assemble a one-page portfolio with avatar, bio, location, CV button, and social icons without writing templates.
• Privacy-conscious site owners: collect contact requests through a clipboard-drafting form that needs no backend and exposes no address.
• Theme customizers: override any partial by placing a file at the same path in the site's layouts/ directory, or override design tokens from config.

How does Freaky work?

1. Add the theme as a Git submodule or clone into themes/freaky and set theme = "freaky" in hugo.toml.
2. Copy the parameters from exampleSite/hugo.toml and adapt identity, hero, orgs, tracks, social links, and contact purposes.
3. Add markdown files under content/projects/, content/publications/, content/articles/, and content/blogs/ with the specified front matter.

FAQ

Is Freaky free?

Yes. Freaky is released under the MIT License; the LICENSE file in the repository covers the terms. The author asks that you keep the footer credit, which is shown by default and can be hidden with hideThemeCredit = true in params.

Does the contact form need a backend?

No. The form drafts the message with the purpose, sender address, and description, then copies it to the visitor's clipboard. No email address is exposed and no server is required.

Which Hugo content sections are supported?

Projects, publications, articles/news, and blogs. Each section appears only when it contains pages, and its navigation link is hidden automatically when empty.

Is there a site-views counter?

The theme supports an optional counter, disabled by default. You supply an endpoint returning JSON with a numeric count field and set count_url under [params.siteviews].