jerryc127/hexo-theme-butterfly is a JavaScript project with 8.4k stars in the UI / UX space. 🦋 A Hexo Theme: Butterfly
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
💡 Hexo 5+ automatically loads _config.butterfly.yml from the blog root. On Windows, use copy themes\butterfly\_config.yml _config.butterfly.yml for Git installs, or copy node_modules\hexo-theme-butterfly\_config.yml _config.butterfly.yml for npm installs.
⚠️ After this, edit only _config.butterfly.yml. Don't delete the theme's own _config.yml, and keep custom files and images out of the theme's source/ folder — upgrades may overwrite them.
Install the renderers and preview locally:
npm install hexo-renderer-pug hexo-renderer-stylus --save
hexo clean && hexo s
🔄 Upgrade
Git install
cd themes/butterfly
git pull
npm install
npm update hexo-theme-butterfly
Before upgrading, back up your config. After upgrading, check Releases for _config changes and merge them into _config.butterfly.yml.
✨ Theme Features
💡 All features can be configured in _config.butterfly.yml. See the theme configuration docs for details.
🎨 Design
✅ Card-based design — Modern card layout
✅ Rounded or square corners — Configurable corner radius
✅ Responsive layout — Looks great on any screen size
✅ Two-column layout — Optimized for reading
✅ Dark mode — Easy on the eyes at night
📝 Content
✅ Multi-level menu — Nested navigation menus
✅ Reading mode — Distraction-free reading
✅ Table of contents — Available on desktop and mobile
✅ Word count — Shows the word count and estimated reading time
✅ Related posts — Smart recommendations at the end of a post
✅ Outdated post warning — Alerts readers when a post may be out of date
✅ Traditional/Simplified Chinese — Convert between Traditional and Simplified Chinese
✅ Tag plugins — Extra tags for richer content
🔍 Search & Navigation
✅ Multiple search options — Algolia, local search, or DocSearch
✅ Built-in 404 page — A polished error page
✅ PJAX — Smooth page transitions
🎨 Code Display
✅ Syntax highlighting — Several built-in themes (darker, pale night, light, ocean)
✅ Code block tools — Language labels, folding, copy button, word wrap
✅ Math formulas — MathJax and KaTeX support
💬 Social Interaction
✅ Multiple comment systems — Disqus, Gitalk, Valine, Waline, Twikoo, Giscus, Artalk, and more
✅ Two comment systems at once — Use two systems side by side
✅ Sharing — Share.js and AddToAny
✅ Live chat — Chatra, Tidio, or Crisp
📊 Analytics & Statistics
✅ Visit counter — Busuanzi
✅ Site analytics — Google Analytics, Baidu Analytics, Cloudflare Analytics, Microsoft Clarity, or Umami
✅ Search engine verification — Google and Baidu
✅ Ads — Google AdSense and custom ad slots
🎪 Visual Effects
✅ Typing effects — activate_power_mode animations
✅ Background effects — Static, dynamic, or fluttering ribbons, plus Canvas Nest
✅ Mouse effects — Fireworks, hearts, and text on click
✅ Loading animations — Preloader or a pace.js progress bar
✅ Image lightbox — medium-zoom or Fancybox
✅ Lazy loading — Images load as they enter the viewport
🛠️ Advanced Features
✅ PWA — Progressive Web App support
✅ Copy protection — Disable copying or append a copyright notice
✅ Theme customization — Custom color schemes
✅ Charts — Mermaid flowcharts and Chart.js charts
✅ Music notation — ABCJS support
✅ Post series — Group posts into series
✅ instant.page — Preload pages for faster navigation
✅ Snackbar — Elegant toast notifications
🤝 Contributors
Thanks to everyone who has contributed to Butterfly!
📸 Screenshots
⭐ Star History
🤝 Building a Better Theme Together
We believe open source thrives on participation. Whether you're a developer, a designer, or a user, you can help make Butterfly better.
💬 Get Help & Support
🐛 Found a bug? → Open an issue and let's fix it together.
💡 Have an idea? → Start a discussion to share it.
📚 New to Butterfly? → Read the documentation.
❓ Stuck? → Check the FAQ for common problems and fixes.
📦 What's new? → See Releases for version notes and _config changes.
💬 Want to chat? → Join the Telegram group.
🎯 Contributing
Want to help? Contributions of every kind are welcome:
Yes — jerryc127/hexo-theme-butterfly ships under the Apache-2.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/jerryc127/hexo-theme-butterfly.
What else is in the UI / UX space?
jerryc127/hexo-theme-butterfly is tracked by TopGit under the UI / UX category, alongside 5 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is jerryc127/hexo-theme-butterfly?
jerryc127/hexo-theme-butterfly (jerryc127/hexo-theme-butterfly) is a JavaScript project on GitHub. From the project's own README: 🦋 A Hexo Theme: Butterfly
What license does jerryc127/hexo-theme-butterfly use?
jerryc127/hexo-theme-butterfly is released under the Apache-2.0 license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where can I see jerryc127/hexo-theme-butterfly in action?
The project maintains a homepage at https://butterfly.js.org. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about jerryc127/hexo-theme-butterfly?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/jerryc127/hexo-theme-butterfly is the definitive source.
Why is jerryc127/hexo-theme-butterfly categorized under UI / UX?
TopGit places jerryc127/hexo-theme-butterfly in the UI / UX category based on its GitHub topics and description (tagged: "butterfly", "hexo", "hexo-theme"). Categories are assigned from real repository metadata, not editorial guesswork.
Read full README in the tab above.
Is hexo-theme-butterfly worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of hexo-theme-butterfly.