Riana

Riana is a simple, responsive theme for the Hexo static site generator, offering a clean reading experience and an automatic dark mode.

What is Riana?

Riana is a minimal Hexo theme designed for personal blogs and content-focused websites. It takes your Hexo Markdown posts and renders them into a responsive, mobile-first layout. Built by hothoney and hosted on GitHub, the theme uses Jade (Pug) templates through the hexo-renderer-jade package and styles with SCSS via hexo-renderer-scss. A live preview is available at https://riana.hoon.cc/.

Key features

• Responsive layout — The theme adapts to any screen size, from phones to desktop monitors, so posts and navigation remain readable without horizontal scrolling.
• Dark mode — A built-in dark mode toggle lets readers switch to a low-light palette, which is comfortable for nighttime reading.
• Hexo integration — Installs directly into a Hexo project's themes folder; only two additional renderer packages are required.
• Jade templating — Page templates are written in Jade (Pug) syntax, making it easy for developers familiar with that preprocessor to customize.
• SCSS styling — Styles are authored in SCSS, allowing variables, mixins, and nesting for maintainable theming.

Who is Riana for?

• Personal bloggers — Set up a clean, fast blog on Hexo with minimal configuration and a focus on typography.
• Hexo developers — Customize a small, hackable theme via Jade and SCSS without learning a large framework.
• Design-conscious writers — Present long-form articles with responsive layouts and dark mode for readers.

What can you do with Riana?

• Publish a personal blog — Write posts in Markdown, run Hexo, and get a responsive site with automatic dark mode.
• Prototype a portfolio — Use the minimal layout to display a few projects or an about page; though the theme is oriented toward article lists.
• Learn Hexo theming — Study a small, readable codebase that demonstrates how to build Hexo themes with Jade and SCSS.

How does Riana work?

Install Riana by cloning the GitHub repository into your Hexo themes folder:

git clone git@github.com:hothoney/hexo-theme-riana themes/riana

Then install the required renderers with either yarn (yarn add hexo-renderer-jade hexo-renderer-scss) or npm (npm i hexo-renderer-jade hexo-renderer-scss). After that, set the theme in your Hexo config and generate your site.

FAQ

Is Riana free?

Riana is publicly available on GitHub and can be cloned and used without paying a fee. No commercial license or pricing information is stated on the theme page.

Does Riana support dark mode?

Yes. The theme includes a dark mode feature that changes the color palette for lower-light environments. The README shows an animated preview demonstrating the toggle effect.

What dependencies does Riana require?

Riana needs hexo-renderer-jade for its Jade templates and hexo-renderer-scss for its SCSS styles. Both can be installed through npm or yarn after cloning the theme.

Is Riana responsive?

The theme's first listed feature is a responsive layout. It scales to the device width and aims to give a consistent view whether viewed on a phone, tablet, or desktop.

Can I customize the theme?

Because templates are written in Jade and styles in SCSS, developers can modify the markup and styling. The theme is minimal, so the codebase is small enough to explore and adjust.