Minimalist page style with no flashy animations
HexoBlog
hexo-theme-sosimple — Hexo Blog Template
By Lhcfl
hexo-theme-sosimple is a minimalist blog theme for Hexo that emphasizes plain HTML readability and an animation-free page style, with built-in table of contents generation, full-text fuzzy search, dark/light mode switching, and comments.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Desktop homepage1 / 2
Desktop captureTop of page
Actual screenshot captured by the server browser.
All pages & views 2
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-02View source
What stands out
A quick read of the recorded project description.
Optimized for environments without CSS or JavaScript, still displaying properly in plain HTML
Supports automatic table of contents generation, built-in full-text fuzzy search, dark/light mode switching, and comments
Uses a modern templating language with fairly complete type annotations; source organized into TypeScript and SCSS
Provides GitHub Actions build and format-checking workflows, plus pnpm format and pnpm lint commands
Template Details
hexo-theme-sosimple is a Hexo blog theme hosted on GitHub, created by Lhcfl and released under the MIT license. The theme is positioned as minimalist: it avoids flashy animations and keeps page styling simple; it is also optimized for environments without CSS or JavaScript, ensuring it still displays properly in plain HTML—you can even copy the entire page content into a Markdown editor and retain formatting.
In terms of features, the README lists automatic table of contents generation, built-in full-text fuzzy search, dark/light mode switching, and comments. The theme uses a modern templating language with fairly complete type annotations; the source is organized into TypeScript and SCSS directories, and also includes i18n language files, Hexo scripts, and HTML assets. The repository provides GitHub Actions workflows for build and format checking, and offers pnpm format and pnpm lint commands for local formatting and linting.
Installation involves cloning the repository into the themes/SoSimple directory of a Hexo project, running pnpm i in the theme directory, copying _config.example.yml to _config.yml for configuration, and setting theme: SoSimple in the Hexo configuration. Updates are done via git pull origin main. The README does not specify the theme's required Hexo version, nor does it state support for package managers other than pnpm.
HexoBlog
Is it right for your project?
Use Cases
- Building a text-focused personal blog with Hexo
- Scenarios where pages should remain readable when JavaScript is disabled or styles fail to load
- Sites needing common blog features such as table of contents, full-text fuzzy search, dark/light switching, and comments
- Developers willing to use pnpm and the theme source for local formatting, linting, and further development
Suitable For
- Hexo users who prefer minimalist typography and do not seek animation effects
- Writers who value plain HTML readability and content copyability
- Bloggers who need built-in search and table of contents and do not want to configure extra plugins
- Developers comfortable installing theme dependencies with pnpm and configuring the theme
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Clone the repository into the themes/SoSimple directory of a Hexo project, and run pnpm i in the theme directory.
- 2
Copy _config.example.yml to _config.yml and edit as needed.
- 3
Set theme to SoSimple in the Hexo configuration.
- 4
To update the theme, run git pull origin main in the theme directory.
- 5
After modifying theme files, use pnpm format and pnpm lint for formatting and linting.
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not imply that external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version's code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- When installing the theme, you must run pnpm i in the theme directory to install dependencies, otherwise the theme cannot build or run properly.
- Before use, copy the example configuration file to _config.yml and edit the configuration yourself.
- The theme must be enabled by setting theme to SoSimple in the Hexo site configuration.
- Updating the theme requires running git pull origin main in the theme directory, depending on Git and remote repository access.
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses; the code's MIT license alone is not sufficient to determine this.
- External services such as domains, hosting, databases, payments, or AI may incur separate charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
pnpm i # You must do this
Original README
copy `_config.example.yml` to `_config.yml` and edit it.
Original README
Change your hexo config: `theme: SoSimple`
Original README
https://github.com/Lhcfl/hexo-theme-sosimple/blob/main/LICENSEhttps://github.com/Lhcfl/hexo-theme-sosimple/blob/main/README.mdgit pull origin main
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 77 / 100
- Technologies
- Hexo
- Website type
- Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2025-03-28
- Screenshot last checked
- 2026-10-02
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Hexo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: e7f37d846fc40b20bfd73978515ab24638fc53eda7a5d45a5e9d0df49691bb46
2026-10-02T15:01:27.026Z
Source file / repository<div align="center"> **So Simple!**  **Minimalist, fast, morden, full-featured hexo theme** [](https://github.com/Lhcfl/hexo-theme-sosimple/actions/workflows/test_and_build.yml) [](https://github.com/Lhcfl/hexo-theme-sosimple/actions/workflows/format_test.yml) </div> hexo-theme-sosimple is a minimalist theme. Live Demo: https://lhcfl.github.io/hexo-theme-sosimple/ - 📄 **Minimalist**: No fancy animations, dedicated to providing the purest page style. - ⏱ **Super Speed**: Only 22.5 kB compressed javascript and css files, provides the fastest DOMContentLoaded speed. - 💻 **Morden**: Use modern template language and complete type annotations to provide a better development experience, with ten-years-ahead-of-hexo technology stack. - 😎 **Geek**: Optimized for no CSS and no JavaScript to ensure that it can be displayed normally under pure HTML. You can even just copy the entire page and paste it into a Markdown editor with the nice formatting kept :\) - ✨ **Full Featured**: Supports automatic generating TOC, built-in full-text fuzzy search, dark/light mode switching, comments, and etc. ## Installation ```bash git clone https://github.com/Lhcfl/hexo-theme-sosimple.git themes/SoSimple cd themes/SoSimple pnpm i # You must do this ``` ### Configuration copy `_config.example.yml` to `_config.yml` and edit it. Change your hexo config: `theme: SoSimple` ### Update ```bash git pull origin main ``` ## Development ### Structures - `.github`: GitHub CI config file - `languages`: I18n files - `scripts`: Hexo scripts - `source`: HTML assets - `src`: Typescript and SCSS source dir. ### Formatting After modifying the theme file, you can format it with the following command: ```bash pnpm format pnpm lint ``` See `package.json`
Explore similar templates
Compare previews and descriptions within the same stack and category.
hexo-theme-matery
hexo-theme-matery is a Material Design, responsive Hexo blog theme with homepage carousel, waterfall post list, timeline archive, word cloud tags, radar chart categories, and an about page.
Hexo · Blog
hexo-theme-cactus
Cactus is a responsive Hexo theme for personal websites and blogs, maintained by probberechts. It offers four color schemes (dark, light, white, classic), configurable navigation, homepage post lists, project lists, social links, and copyright year ranges.
Hexo · Blog
hexo-theme-volantis
Volantis is a blog theme for Hexo, distributed as the npm package hexo-theme-volantis and enabled by setting theme to volantis in the Hexo site's _config.yml. It requires Hexo 7.3+, hexo-cli 4.3+, Node.js 22.x LTS+, and npm 10.x LTS+.
Hexo · Blog
hexo-theme-aurora
Hexo Theme Aurora is a futuristic Hexo blog theme built around aurora gradients and a magazine-style grid layout.
Hexo · Blog
hexo-theme-Claudia
Claudia is a Hexo blog theme focused on a clean look and easy configuration. It automatically follows the device's dark mode and claims a 90+ Lighthouse score.
Hexo · Blog
hexo-theme-A4
hexo-theme-A4 is a minimalist Hexo blog theme that mimics the texture of A4 paper, emphasizing simplicity, small size, and minimal configuration.
Hexo · Blog