Vexo

Vexo is a Hexo theme inspired by the Vue.js official website, designed to give static blogs a clean, Vue-styled layout.

What is Vexo?

Vexo is a Hexo theme that replicates the visual style of the Vue.js official website for static blogs. It takes a standard Hexo project — Markdown posts, a project _config.yml, and the theme folder — and outputs a fully responsive static site with article listings, archives, an about page, and a project showcase. The theme is created by yanm1ng, distributed on GitHub under the MIT license, and has over 600 stars. It runs on Hexo, uses EJS for templating and Stylus for styling, and is installable with a simple git clone.

Key Features

• Fully Responsive — The layout adapts automatically to different screen sizes, from mobile phones to desktop monitors.
• Multiple Comment Systems — Switch between Gitment, Utterances, Youyan, or Disqus by changing one comment variable in themes/vexo/_config.yml; Gitment and Utterances both build on GitHub Issues.
• Local Search — Pair with hexo-generator-searchdb to enable a search button in the menu bar that filters posts without a third-party service.
• QR Code Sharing and Reward — Posts get a share QR code, and you can place your Alipay or WeChat payment QR images at themes/source/css/images to accept tips.
• Article Catalog — A table of contents is generated for each post, added in the 2017-09-21 changelog.
• SEO and Mobile Enhancements — Includes SEO metadata and an immersive status bar for mobile browsing.
• Post Banners and Image Effects — Add a banner URL in front-matter for a custom header image; image zoom and a loading bar (via nprogress) are included since mid-2017.
• Extra Page Types — Ships with archive and about pages, plus a "project" page that can display GitHub repositories.

Who is it for?

• Hexo users — Developers or writers already on Hexo who want a Vue-inspired redesign without changing their static site generator.
• GitHub-based comment lovers — Users who want discussions managed as GitHub Issues via Gitment or Utterances.
• Mobile-first readers — Blog owners who care about a responsive layout and an immersive status bar on mobile browsers.

What can you do with Vexo?

• Style a tech blog like Vue's site — Replace your Hexo theme, copy _source files into source/, and set theme: vexo to get the Vue look.
• Add comment widgets in minutes — Configure gitment_owner, gitment_repo, and OAuth keys, or just set utterances_repo and the issue term.
• Provide a reward channel — Swap in your own Alipay/WeChat QR code images to let readers pay you.
• Enable search and personal links — Turn on local_search and fill in your GitHub, Zhihu, Twitter, or Weibo usernames.

How does Vexo work?

1. Clone the theme into themes/vexo and copy the _source directory into your Hexo source folder.
2. Update the Hexo project config so the active theme is vexo.
3. Edit themes/vexo/_config.yml with your comment system, social links, and search settings.
4. Write posts in Markdown with front-matter fields like title, date, banner, and tags; the theme renders them into the Vue-styled layout.

FAQ

Is Vexo free?

Vexo is open source under the MIT license, so it is free to use, modify, and redistribute.

Which comment systems does Vexo support?

Vexo supports Gitment, Utterances, Youyan, and Disqus. You select one by setting the comment field in the theme's _config.yml.

How do I add a banner image to a post?

Add a banner: your-banner-link.jpg line to the post's front-matter, and Vexo uses that URL as the post's header image.

Does Vexo include a search feature out of the box?

No, the theme provides a search button only after you install hexo-generator-searchdb and set local_search.enable to true.