Based on Cupertino design, with official description stating its appearance is close to Apple Newsroom
hexo-theme-cupertino — Hexo Blog Template
By MrWillCom
A Hexo blog theme with a Cupertino design style, visually close to Apple Newsroom, installable via npm or by cloning into the themes directory.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Since v2, supports installation via npm, or cloning into the themes/cupertino directory
Uses a separate _config.cupertino.yml to override the theme's default configuration
Provides an online preview and a separate documentation site
Released under the MIT license, allowing free use, modification, commercial use, and distribution of the code
Template Details
hexo-theme-cupertino is a free theme developed by MrWillCom for Hexo blogs, released under the MIT license. The theme is based on the Cupertino design language, and its official description states that its appearance is similar to Apple Newsroom, aiming to give Hexo blogs typography and details closer to Apple's style.
There are two installation methods: since v2, it can be installed via npm as hexo-theme-cupertino, or the repository can be cloned into the blog's themes/cupertino directory and dependencies installed; then set theme to cupertino in the blog's _config.yml. For configuration, a _config.cupertino.yml file must be placed alongside _config.yml to override the default configuration, with more detailed instructions pointing to a separate theme documentation site.
The repository provides an online preview (blog.mrwillcom.com) and a documentation site (cupertino.mrwillcom.com). The README also includes badges for Product Hunt, npm downloads, GitHub Release, as well as contribution and donation links. Third-party assets of the theme (demo images, fonts, icons, etc.) must be checked separately under their respective licenses; the MIT license for the code does not cover these.
Is it right for your project?
Use Cases
- Changing an existing Hexo blog to an Apple-style blog theme
- Building a Hexo personal blog focused on article reading with a clean visual style
- Cloning the theme source locally to modify styles and configuration as needed
- Referencing its Cupertino-style typography for a Hexo site prototype
Suitable For
- Users who already have a Hexo blog set up and want to change the theme
- Bloggers who prefer an Apple Newsroom-style visual style
- Developers who can manage theme dependencies via npm or git
- Site maintainers who need theme code that can be modified and used commercially under the MIT license
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
A Hexo blog environment must be prepared first
- 2
npm install: npm install hexo-theme-cupertino; or git clone into themes/cupertino and run npm install in that directory
- 3
Set theme: cupertino in the blog's _config.yml
- 4
Create _config.cupertino.yml alongside _config.yml and write custom configuration to override defaults
- 5
To update: for npm installation run npm install hexo-theme-cupertino@latest; for cloning, run git pull in the theme directory and reinstall dependencies
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 mean 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
- Demo images, fonts, icons, and other third-party assets must be checked under their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis
https://github.com/MrWillCom/hexo-theme-cupertino/blob/master/LICENSEhttps://github.com/MrWillCom/hexo-theme-cupertino/blob/master/README.mdPermission is hereby granted, free of charge
Original License Text
Compiled by DeepSeek based on repository license and README ·2026-10-01. 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 · 91 / 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
- 2026-08-11
- Screenshot last checked
- 2026-10-01
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: e3d63454ecedb7980b3688621155d7e5b1852f5481094a7acd7e9801c504ce77
2026-10-01T03:12:09.755Z
Source file / repository<p align="center">
<img src="./assets/logo-v2.svg" width="128">
</p>
<h1 align="center">Hexo Theme Cupertino</h1>
<p align="center">The Hexo Blog Theme Cupertino.</p>
<p align="center"><a href="https://blog.mrwillcom.com/"><strong>Preview</strong></a> / <a href="https://cupertino.mrwillcom.com/">Docs</a></p>
<p align="center"><a href="https://www.producthunt.com/products/hexo-theme-cupertino?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-hexo-theme-cupertino" target="_blank" rel="noopener noreferrer"><img alt="Product Hunt Badge" width="200" height="40.5" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1067113&theme=light&t=1769262103936"></a></p>
<p align="center">
<a href="https://github.com/MrWillCom/hexo-theme-cupertino/releases/latest">
<img alt="GitHub Release" src="https://img.shields.io/github/v/release/MrWillCom/hexo-theme-cupertino?style=for-the-badge&logo=github&logoColor=181717&labelColor=EEEEEE">
</a>
<a href="https://www.npmjs.com/package/hexo-theme-cupertino">
<img alt="NPM Downloads" src="https://img.shields.io/npm/dm/hexo-theme-cupertino?style=for-the-badge&logo=npm&logoColor=CB3837&labelColor=EEEEEE&color=8A56FF">
</a>
<img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/MrWillCom/hexo-theme-cupertino?style=for-the-badge&logo=github&logoColor=181717&labelColor=EEEEEE&color=F7D76E">
</p>
<p align="center">
<a href="https://pkg.pr.new/">
<img alt="Continuous Releases" src="https://img.shields.io/github/actions/workflow/status/MrWillCom/hexo-theme-cupertino/continuous-releases.yml?style=for-the-badge&logo=stackblitz&logoColor=1269D3&label=Continuous%20Releases&labelColor=EEEEEE&color=1269D3">
</a>
<a href="https://github.com/changesets/changesets">
<img alt="Changesets" src="https://img.shields.io/badge/🦋-Changesets-0195FE?style=for-the-badge&labelColor=EEEEEE">
</a>
</p>
<p align="center">✨ <em>Give a star if you like this!</em> ✨</p>

This is a modern and elegant theme for your Hexo blog, which is beautifully designed and has gorgeous details. It's based on Cupertino Design, so it looks similar to [Apple Newsroom](https://www.apple.com/newsroom/).
With Theme Cupertino, your blogging experience will be hugely elevated, and your ideas can be shared in an effortless way.
## Installation
Before getting started, make sure you have already set up a [Hexo](https://hexo.io/) blog.
Since v2, you can install via npm:
```sh
$ npm install hexo-theme-cupertino
```
Or, you may clone Theme Cupertino to `themes/cupertino`:
```sh
$ git clone https://github.com/MrWillCom/hexo-theme-cupertino.git themes/cupertino
# install dependencies
$ cd themes/cupertino
$ npm install
```
Then, go to your blog configuration `_config.yml` and set:
```yaml
theme: cupertino
```
## Update
If you installed Theme Cupertino via npm, run:
```sh
$ npm install hexo-theme-cupertino@latest
```
Or if you cloned it via Git, go to the theme directory and pull the latest changes:
```sh
$ cd themes/cupertino
$ git pull
# install latest dependencies
$ npm install
```
## Configuration
You need a `_config.cupertino.yml` file beside `_config.yml` to contain your configuration, which will override the defaults.
For more detailed guides, visit [Theme Cupertino Docs](https://cupertino.mrwillcom.com/).
## Contributing
All friendly contributions are welcome! Start contributing by following the existing issues or little fixes.
Not familiar with code? It's okay, feel free to report bugs or suggest something.
## Donating
If you like Theme Cupertino, please consider donating to encourage me. Your support is greatly appreciated! Starring and sharing this repository will also help a lot.
<p>
<a href="https://liberapay.com/MrWillCom/donate">
<img alt="Donate using Liberapay" src="https://liberapay.com/assets/widgets/donate.svg">
</a>
<a href="https://www.patreon.com/MrWillCom">
<img alt="Donate using Patreon" src="https://img.shields.io/badge/Patreon-F96754?style=for-the-badge&logo=patreon&logoColor=FFFFFF">
</a>
</p>
## Activities

## Contributors
Theme Cupertino would not be possible without the help from the contributors.
<a href="https://github.com/MrWillCom/hexo-theme-cupertino/graphs/contributors">
<img src="https://contrib.rocks/image?repo=MrWillCom/hexo-theme-cupertino">
</a>
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
