hexo-theme-butterfly

A modern, elegant and feature-rich theme for Hexo

📢 Demo: Butterfly Official | CrazyWong's Blog

📖 Documentation: English Docs | 中文文档

🚀 Quick Start

💾 Installation

Method 1: Git Installation (Recommended)

💡 Tip: If GitHub access is slow in mainland China, you can use the Gitee Mirror

Execute in your Hexo blog root directory:

# Install stable version (recommended)
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

# Install development version (early access to new features)
git clone -b dev https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

Method 2: NPM Installation

⚠️ Note: NPM installation only supports Hexo 5.0.0 and above

npm install hexo-theme-butterfly

⚙️ Theme Configuration

1. Enable Theme: Modify your Hexo configuration file _config.yml:

theme: butterfly

2. Install Dependencies: If you haven't installed pug and stylus renderers, please run:

npm install hexo-renderer-pug hexo-renderer-stylus --save

✨ Theme Features

🎨 Design Style

• [x] Card-based Design - Modern card-style layout
• [x] Rounded/Square Design - Customizable border styles
• [x] Responsive Design - Perfect adaptation to all screen sizes
• [x] Two-column Layout - Optimized reading experience
• [x] Dark Mode - Eye-friendly night mode

📝 Content Features

• [x] Multi-level Menu - Support for secondary navigation menus
• [x] Reading Mode - Focused article reading experience
• [x] TOC Navigation - Desktop and mobile TOC support
• [x] Word Count - Display article word count and reading time
• [x] Related Articles - Smart recommendation of related content
• [x] Outdated Reminder - Automatic article update status alerts
• [x] Traditional/Simplified Chinese - Support for Traditional and Simplified Chinese switching
• [x] Tag Plugins - Rich tag plugin support

🔍 Search & Navigation

• [x] Multiple Search Options - Algolia Search / Local Search / Docsearch
• [x] Built-in 404 - Beautiful 404 error page
• [x] Pjax Support - Smooth page transition experience

🎨 Code Display

• [x] Syntax Highlighting - Built-in multiple themes (darker/pale night/light/ocean)
• [x] Code Features - Language display/fold expand/copy button/auto-wrap
• [x] Math Formulas - Support for Mathjax and Katex

💬 Social Interaction

• [x] Multiple Comment Systems - Disqus/Gitalk/Valine/Waline/Twikoo/Giscus/Artalk etc.
• [x] Dual Comments Support - Enable two comment systems simultaneously
• [x] Share Features - Sharejs/Addtoany sharing components
• [x] Live Chat - Chatra/Tidio/Crisp instant messaging

📊 Analytics & Statistics

• [x] Visit Statistics - Busuanzi counter
• [x] Site Analytics - Google Analytics/Baidu Analytics/Cloudflare Analytics/Microsoft Clarity/Umami
• [x] Webmaster Verification - Major search engine verification
• [x] Ad Support - Google AdSense/custom ad slots

🎪 Visual Effects

• [x] Typing Effects - activate_power_mode animations
• [x] Background Effects - Static ribbons/dynamic ribbons/floating ribbons/Canvas Nest
• [x] Mouse Effects - Fireworks/hearts/text click effects
• [x] Loading Animations - Preloader and pace.js progress bars
• [x] Image Effects - Medium Zoom/Fancybox image lightbox
• [x] Lazy Loading - Image lazy loading optimization

🛠️ Advanced Features

• [x] PWA Support - Progressive Web App
• [x] Copy Protection - Disable text copying/copyright info append
• [x] Theme Customization - Custom site color schemes
• [x] Chart Support - Mermaid flowcharts/Chart.js data charts
• [x] Music Notation - ABCJS music notation support
• [x] Music Player - APlayer/Meting music playback
• [x] Article Series - Series article organization
• [x] Instantpage - Page preloading acceleration
• [x] Snackbar - Elegant notification messages

🤝 Contributors

Thanks to all the developers who have contributed to the Butterfly theme!

📸 Screenshots

⭐ Star History

🤝 Building a Better Theme Together

We believe the power of open source comes from everyone's participation! Whether you're a developer, designer, or user, you can contribute to the development of the Butterfly theme.

💬 Get Help & Support

• 🐛 Found a bug? → GitHub Issues - Let's solve it together!
• 💡 Have ideas? → GitHub Discussions - Share your creative ideas!
• 📚 Learning to use? → Official Documentation - Detailed usage guide
• 💬 Real-time discussion? → Telegram Group - Chat with community members

🎯 Contributing

Want to make Butterfly better? We welcome any form of contribution:

• 🔧 Code Contributions - Fix bugs, add new features, optimize performance
• 📝 Documentation - Improve docs, translate content, write tutorials
• 🎨 Design Suggestions - UI/UX improvements, theme colors, icon design
• 🧪 Testing & Feedback - Test new features, report issues, provide user experience
• 💰 Financial Support - Sponsor the Project - Support long-term development

📄 License

This project is licensed under the Apache 2.0 License.

🙏 Acknowledgments

This theme is developed based on hexo-theme-melody. Thanks to the original author for their excellent work that provided inspiration and foundation!

Thanks to all friends who have contributed to the development of the Butterfly theme. Your support has made this theme continuously improve and progress.

✨ If this theme helps you, please give us a ⭐ Star! ✨