Lap is a simple Hexo blog theme designed for writing and communicating, offering a minimal layout with Bootstrap-inspired styling and a range of optional integrations.
What is Lap?
Lap is a minimal Hexo theme that requires Hexo 3.0 or newer to run. It takes standard Hexo markdown posts as input and renders them into a static blog with a clean reading layout. The theme borrows styles from some Bootstrap themes, according to its readme, and focuses on content over decoration. It was created by BosenY and is demonstrated on his blog at https://boseny.github.io.
Key Features
The theme's feature set is deliberately basic but covers the essentials for a personal blog.
- Social links — Display any number of social profiles (GitHub, Twitter, Weibo, Zhihu, Douban, Lofter) in the sidebar using the social config block with key and link fields.
- Comment systems — Three choices: Disqus, Livere, and Gitment (the author's recommendation for GitHub-based comments), each toggled with a boolean flag and the appropriate API keys.
- Search — Sidebar search requires installing hexo-generator-search and hexo-generator-searchdb via yarn; once added, a search box appears.
- PWA support — Add hexo-offline to enable offline access and progressive web app behavior for the blog.
- Analytics and ads — Google Analytics, Baidu Analytics, and Google AdSense can be configured by pasting tracking IDs into the theme's _config.yml.
- Table of contents — Enable a per-post TOC with toc.enable; anchorjs provides anchor links on headings when anchorjs is set to true.
- Custom post backgrounds — Set headerImg in a post's front matter to show a background image stored in source/images.
- Draw animation — A decorative falling-heart effect from the Draw plugin with configurable count, icon, and color.
Who is it for?
Lap suits bloggers who already use Hexo and want a straightforward theme without extra page templates. It is also aimed at writers who prefer a distraction-free layout and want to connect with readers through multiple comment and social channels. Developers comfortable editing YAML configs and running yarn commands will get the most out of enabling search and PWA features.
What can you do with Lap?
- Personal bloggers: Publish markdown posts and customize the sidebar with categories, links, and social profiles.
- Tech writers: Add Gitment comments so readers can leave GitHub-issue comments on posts.
- Offline readers: With hexo-offline installed, visitors can browse the blog even when disconnected.
How to install
Clone the repository into your Hexo themes directory (git clone https://github.com/BosenY/Lap.git), then change the theme setting in your site's _config.yml to Lap. Optional functionality requires installing plugins via yarn add hexo-generator-search hexo-generator-searchdb and yarn add hexo-offline.
