HexoBlog

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.

3 previews
Desktop homepage1 / 3
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-01View source

What stands out

A quick read of the recorded project description.

01

Based on Cupertino design, with official description stating its appearance is close to Apple Newsroom

02

Since v2, supports installation via npm, or cloning into the themes/cupertino directory

03

Uses a separate _config.cupertino.yml to override the theme's default configuration

04

Provides an online preview and a separate documentation site

05

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.

HexoBlog

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. 1

    A Hexo blog environment must be prepared first

  2. 2

    npm install: npm install hexo-theme-cupertino; or git clone into themes/cupertino and run npm install in that directory

  3. 3

    Set theme: cupertino in the blog's _config.yml

  4. 4

    Create _config.cupertino.yml alongside _config.yml and write custom configuration to override defaults

  5. 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

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This 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

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&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;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&amp;theme=light&amp;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>

![Highlights until v2.3.0](https://github.com/user-attachments/assets/d58b92f4-83dc-4048-9ba3-ead3795f6367)

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

![Repobeats analytics image](https://repobeats.axiom.co/api/embed/36f7fe575bf26420dc25e3c99789adb523f520d4.svg)

## 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>
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.