Hugo Theme Farallon
Hugo Theme Farallon is a single-column Hugo theme that converts Markdown content into a static blog site, optimized for clarity and fast output. It runs on Hugo (compatible with v0.146.0 as of version 0.5.0), is distributed as a Git submodule from the GitHub repository bigfa/hugo-theme-farallon, and has a full demo site at bigfa.github.io. The theme takes standard Hugo content files as input and produces a static site with category and tag pages, local search, pagination, and multiple post types.
What is Hugo Theme Farallon?
Hugo Theme Farallon is a single-column Hugo theme that renders Markdown-based blog content into a static website with a focus on minimal design and static-site speed. It is maintained by bigfa (the owner of the GitHub repository) and is compatible with Hugo v0.146.0 as of release 0.5.0. Input is standard Hugo content (posts, memos, friend links), and output is a fully static site including category and tag archives, search index, and pagination.
Key Features
- Local search — Builds a local search index from site content; the search assets are bundled with the theme since version 0.7.7, so no external search service is required.
- Dark mode — Light/dark theme toggling was introduced in version 0.2.0, with mobile footer styling fixes and later style refinements.
- Post interactions — Includes post view counts (0.3.9), a like button (0.3.8), and click-to-zoom on post images (0.4.6).
- Memo post type — A dedicated short-form content type (added in 0.3.3) appears in the same feed as full posts, useful for status updates.
- Taxonomy archives — Category and tag pages include cover images and term views (0.7.2); an archives page template was added in 0.6.3 and custom pagination in 0.7.6.
- Douban integration — Syncs Douban reading and movie records through a Cloudflare Worker API using a token from node.wpista.com, added across 0.0.6–0.4.3.
- Comment system — Supports a Cloudflare Worker-based comment system since version 0.4.5, in addition to standard Hugo static comments.
- Customization — Place logo.jpg in your assets/images folder to override the default logo (0.7.2), with options for social icons, a friend links template (0.2.9), table of contents (0.2.2), back-to-top button (0.2.3), and sticky icon (0.3.1).
Who should use Hugo Theme Farallon?
- Minimalist bloggers — Writers who want a clean single-column layout with no sidebars or clutter, ideal for personal journals and article-focused blogs.
- Hugo developers — Users who already run Hugo and want a pre-built theme with local search, dark mode, pagination, taxonomy pages, and a memo post type out of the box.
- Chinese-language content creators — Bloggers who want Douban book/movie synchronization, since the theme includes a token-based Douban workflow via Cloudflare Worker.
- Self-hosting tinkerers — People who like to tweak their theme's SCSS; the source is included, and the release history shows frequent style-focused updates.
What can you do with Hugo Theme Farallon?
- Publish a personal blog: Write Markdown posts with categories, tags, a back-to-top button, table of contents, and relative time display (0.0.4), all in a single-column design.
- Share short updates: Use the memo post type to publish quick notes that mix into your normal feed.
- Show your Douban activity: Link a Douban account via a Cloudflare Worker token and display synced book/movie entries on the site.
- Create a blogroll: Use the friend links template (0.2.9) to build a page linking out to other sites.
How does Hugo Theme Farallon work?
Installation follows the standard Hugo workflow: add the theme as a Git submodule with git submodule add https://github.com/bigfa/hugo-theme-farallon.git themes/farallon, then set theme = 'farallon' in your hugo.toml. For Douban sync, scan the QR code at node.wpista.com with WeChat, enter your Douban numeric ID and save, then click "Get integration token" and put the returned token into your site config under the wpdToken parameter.
FAQ
Is Hugo Theme Farallon free?
Yes, it is an open-source Hugo theme hosted on GitHub with no mention of a paid license in the README. You can add it to a Hugo site via Git submodule and use it indefinitely without cost.
Does Hugo Theme Farallon support dark mode?
Yes, dark mode has been supported since version 0.2.0, and later releases refined its styling. The theme also fixed footer style issues on mobile devices in that same release.
How do I install Hugo Theme Farallon?
Run these two commands in your Hugo project directory: git submodule add https://github.com/bigfa/hugo-theme-farallon.git themes/farallon and then echo "theme = 'farallon'" >> hugo.toml to set it as the active theme.
Can I customize the logo?
Yes. Place a file named logo.jpg inside your site's assets/images folder, and the theme will use it instead of the remote default logo. This behavior was added in version 0.7.2.
Does the theme have search?
Yes. Local search was introduced in version 0.3.0, and the search assets are bundled locally starting in 0.7.7, so it works without an external search provider.
