Minima is a lightweight, clean dark/light mode theme for the Hexo static site generator, built from scratch with Skeleton CSS, vanilla JavaScript, and EJS templates.
What is Minima?
Minima is a Hexo theme created by Adi Sakti Jrs and released under the MIT License (copyright 2020). It takes a standard Hexo site's content — posts, pages, tags, archives, and pagination — and renders it as a minimal, content-focused blog with automatic dark/light mode switching. The theme passes the core of the Hexo Theme Unit Test, so it is compatible with standard Hexo sites. Its main goal is to keep the interface simple so readers focus on the articles, not on the design.
Key Features
- Dark/light mode switch — A customizable icon button toggles between dark and light themes instantly using vanilla JavaScript, with no external theme library.
- Skeleton CSS boilerplate — The layout is built on Skeleton, a minimal CSS framework, keeping the bundle small and reducing render-blocking resources.
- Prism.js syntax highlighting — Code blocks are highlighted using Prism.js, with the theme supporting multiple language syntaxes for developer blog posts.
- Disqus comments — Post pages integrate Disqus for comments, and the comments section is loaded behind a button so pages load faster.
- Fully responsive — The theme adapts to mobile, tablet, and desktop viewports without a separate mobile theme.
- SEO meta tags — Each post supports meta descriptions and social share images that appear in Facebook/Twitter shared links.
- EJS templates — The theme is structured with EJS partials, making it easy to customize layouts and styling directly from the theme folder.
- Customizable theme color — Users can change the accent color from the theme configuration without touching the CSS files.
Who is it for?
- Personal bloggers — Writers who want a clean, uncluttered layout that puts the post content first, ideal for text-heavy blogs.
- Developers — Those who use Hexo and want a lightweight theme that loads quickly, supports Prism.js code highlighting, and is easy to fork and customize.
- Minimalist designers — Users who prefer flat, simple designs without heavy JavaScript or complex animation libraries, since the theme only uses CSS and vanilla JS.
What can you do with Minima?
- Publish a fast personal blog — Deploy a Hexo blog with a small footprint; the theme uses only Skeleton CSS, nanobar.js, and Prism.js, avoiding render-blocking third-party scripts.
- Customize the look without a build step — Edit EJS templates and CSS directly; the theme includes documentation and a quick-start guide for changing colors, icons, and layout.
- Expand with standard Hexo plugins — Because it passes the Hexo Theme Unit Test, it works with standard Hexo configuration for tags, archives, pagination, and SEO.
Pricing
Minima is free to use and modify under the MIT License, with no paid tiers or premium features.
