VNovel is a Hugo theme for publishing novels and serialized fiction, with a reading interface modeled after Pixiv's novel viewer. It turns markdown content into a clean, focused reading page, and it is released as open source under the MIT license.
What is VNovel?
VNovel is an open-source Hugo theme designed specifically for presenting novels and long-form fiction on the web. It takes a standard Hugo site with markdown content and renders it as a clean, reading-focused webpage with a visual style inspired by Pixiv's novel reader. The theme is developed by opera7133, distributed on GitHub, and released under the MIT license.
Key Features
- Responsive layout — The theme adapts to mobile and desktop screens, so the reading experience works on phones, tablets, and monitors.
- Light/Dark mode — A switch on the site lets readers toggle between light and dark color schemes without reloading the page.
- Customizable typography — Site owners can change the font family and background color via the Hugo configuration file.
- Ruby annotations — Supports furigana ruby text, a key requirement for Japanese and light-novel style content.
- Page break controls — Content can be divided with page-break markers, letting you split a story into chapters or installments.
- Google Analytics — Built-in support for adding your Google Analytics tracking ID to the site.
- Giscus comments — Integrates Giscus for GitHub Discussions–based comments, enabling reader replies under each chapter.
- RSS feeds — Automatically generates RSS feeds so readers can subscribe to new chapters.
- i18n (en/ja) — The user interface is translated into English and Japanese.
- Lighthouse 100/100 — The demo site achieves a perfect score on Google Lighthouse's mobile analysis.
Who is it for?
- Web novel writers — Publish serialized fiction with a polished, minimal layout that readers can navigate easily.
- Japanese/light-novel translators — Use ruby furigana and page-break features to present translated works authentically.
- Hugo developers looking for a fast blog theme — Build a lightweight site with Tailwind CSS styling, responsive design, and built-in integrations like Google Analytics and Giscus.
- Self-hosters on Cloudflare Pages — The demo runs on pages.dev, and the theme works with any static host that supports Hugo.
What can you do with VNovel?
- Authors and fanfiction writers: Upload chapters as markdown files, assign tags, and let the theme generate a clean reading page with per-chapter page breaks and RSS updates.
- Translation groups: Present Japanese works with ruby furigana for pronunciation guides, while the light/dark toggle suits both daytime and nighttime reading.
- Bloggers and small publications: Use the theme's built-in Google Analytics, Giscus comments, and RSS to turn a novel archive into a full-featured site with community interaction.
How does VNovel work?
Installation follows the standard Hugo theme workflow: clone the repository into the themes directory or add it as a git submodule, copy the exampleSite's package.json and hugo.toml into your project root, run npm install, and then use hugo server to preview locally or hugo to build the static site. Updating is done with git pull or git submodule update --remote --merge, depending on the install method.
Pricing
VNovel is free and open source under the MIT license. There are no paid tiers, premium features, or licensing fees; the only cost is your own static hosting (the demo uses Cloudflare Pages).
FAQ
Is VNovel free to use?
Yes, VNovel is released under the MIT license, which means you can use, modify, and distribute it freely, even for commercial projects, as long as you keep the license notice.
How do I install VNovel for Hugo?
You can install it by running git clone https://github.com/opera7133/vnovel themes/vnovel, or by adding it as a submodule with git submodule add. Then copy the exampleSite files (package.json and hugo.toml) into your project root, run npm install, and start with hugo server.
Does VNovel support comments?
VNovel integrates Giscus, a comments system powered by GitHub Discussions. You need to configure the Giscus repository and settings in your site configuration for comments to appear under each novel or chapter.
Can I localize VNovel for languages other than English and Japanese?
The built-in interface strings are English and Japanese, but all content is written in your own markdown files, so the theme can host texts in any language. For other UI languages, you can extend the i18n files.
