Fuji is a minimal Hugo theme for building fast, content-focused blogs and documentation sites, with full dark mode support and GitHub Primer markdown styling.
What is Fuji?
Fuji is a Hugo theme created by DSRKafuU, released under the Apache License 2.0. It takes standard Hugo site content — markdown files, front matter, and a config.toml — and generates a static website with a clean reading layout, optional table of contents, license text, and comment sections. The theme is built on the Hugo static site generator and uses SCSS for styling, with separate light and dark color palettes defined as overridable variables.
Key Features
- Full dark mode – The theme ships distinct light and dark palettes as SCSS variables; the dark scheme uses a #2f3136 background and #414449 code background, colors drawn from Discord and GitHub.
- GitHub Primer markdown style – Rendered content follows Primer CSS so headings, code blocks, blockquotes, and links match GitHub’s look; the SCSS even sets the light code background to #f6f8fa.
- i18n support – Includes translations for 11 languages: cs, de, en, eo, fr, ja, nl, pl, pt-pt, zh-hans, and zh-hant, and the i18n folder is open for adding more.
- APlayer integration – A built-in
aplayershortcode embeds audio players with URL, name, artist, and cover, and supports multiple files for playlists. - KaTeX LaTeX rendering – A
mathshortcode renders display and inline equations; setmath = truein front matter or config.toml to enable it per post. - Image zoom and lazy loading – Four shortcode variants (
img-lazy,img-nz,img-nz-lazy, and the default) control zoom and lazyload, with 16 predefined aspect ratios from 40x9 to 9x32. - Multiple comment systems – Supports Disqus, utterances, and DisqusJS (aimed at Mainland China users), and all comment partials can be overridden in your site.
- Customizable SCSS – Override theme variables in
assets/scss/_custom_var.scssor add priority CSS rules inassets/scss/_custom_rules.scss; Hugo extended is required for this.
Who should use Fuji?
- Bloggers who want a minimal, fast blog with dark mode and GitHub-style code formatting.
- Documentation writers – the built-in TOC, LaTeX math, and clean code blocks make it suitable for technical guides and API docs.
- Developers already on Hugo – the theme keeps dependencies light, bundling only APlayer, lazysizes, Fuse.js, and similar small libraries.
- Multilingual site owners – with 11 bundled languages, a single theme can serve an international audience without extra translation work.
What can you do with Fuji?
- Technical bloggers: publish markdown posts with fenced code blocks and LaTeX equations rendered in GitHub Primer style.
- Music enthusiasts: embed audio players directly inside a post using the
aplayershortcode with cover art and artist metadata. - Photographers: use image lazy-loading shortcodes with aspect ratios to keep pages fast and preserve layout stability.
- China-based readers: enable DisqusJS so comment functionality works without relying on blocked external resources.
How do you install and configure Fuji?
Add the theme as a git submodule (git submodule add https://github.com/dsrkafuu/hugo-theme-fuji.git themes/fuji), then copy the config.toml from exampleSite to your site root — that file contains all menu, search, and feature settings. To customize, edit SCSS variables or override partials like partials/favicon.html and partials/comment-*.html. Update the theme later with git submodule update --remote --merge.
FAQ
Is Fuji free to use?
Yes. Fuji is released under the Apache License 2.0, and the underlying libraries it bundles — Primer CSS, APlayer, lazysizes, DisqusJS, ionicons, Fuse.js, and others — are MIT or Apache-2.0 licensed.
Does Fuji support dark mode automatically?
Yes, dark mode is built in. The theme defines separate dark and light palettes as SCSS variables, and the dark scheme uses Discord-like colors such as #2f3136 for the background and #414449 for code blocks.
Which languages does Fuji support?
Fuji ships with 11 language files: Czech, German, English, Esperanto, French, Japanese, Dutch, Polish, Portuguese (Portugal), Simplified Chinese, and Traditional Chinese. The i18n folder is open for contributions.
How do I add LaTeX math to a post?
Write LaTeX with the math shortcode (display or inline) and set math = true in the post’s front matter or in config.toml. KaTeX handles the rendering.
What comment systems are supported?
Fuji supports Disqus, utterances, and DisqusJS. For DisqusJS you must set the disqusJSApi option in config.toml to load its CSS. All comment partials can be overridden to customize behavior.
