Select Version
A new version of NexT will be released every month. You can choose to install the latest version or choose a stable old version.
Option 1: Download the Latest Master Branch
May be unstable, but includes latest features. At most cases useful and recommended for advanced users and for developers.
Option 2: Download the Latest Release Version
At most cases stable. Recommended for beginners.
Option 3: Download the Specific Release Version
In rare cases useful, but not recommended.
You must define version. Let's take v8.0.0 as an example. Replace it with any version from tags list.
Get NexT
There are 2 recommended ways to download NexT: npm and git. You need to choose only one of them. Other installation methods, such as downloading and decompressing the theme source code in zip format from GitHub, are no longer recommended, because the installed theme is difficult to manage and upgrade.
Change dir to site root directory in the command line first, and then continue with the following steps.
Using npm
If you're using Hexo 5.0 or later, you can install hexo-theme-next through npm.
npm install hexo-theme-next@latest |
This variant will install the latest release version.
npm install hexo-theme-next@8.0.0 |
This variant will install the specific release version.
Using git
git clone https://github.com/next-theme/hexo-theme-next themes/next |
Or download via mirror on GitLab:
git clone https://gitlab.com/hexo-theme-next/hexo-theme-next themes/next |
This variant will install the whole repository (with .git directory inside).
And in any time you can update current version with git (instructions below) and switch to any tagged release or on latest master or any other branch.
Get tags list:
$ cd themes/next |
For example, you want to switch on v8.0.0 tagged release version. Input the following command:
$ git checkout tags/v8.0.0 |
If you want to switch on latest release version without defining tag (optional)
git checkout $(git describe --tags $(git rev-list --tags --max-count=1)) |
And if you want to switch back on master branch, input this command:
git checkout master |
git clone --branch v8.0.0 https://github.com/next-theme/hexo-theme-next themes/next |
Or download via mirror on GitLab:
git clone --branch v8.0.0 https://gitlab.com/hexo-theme-next/hexo-theme-next themes/next |
This variant will install the specific release version (with .git directory inside).
And in any time you can switch to any tagged release, but with limit to specific version.
And if you see any error message during update (something like «Commit your changes or stash them before you can merge»), recommended to learn Alternate Theme Config feature. Howbeit, you can bypass update errors by Commit, Stash or Discard local changes. See here how to do it.
Set It Up
When NexT download will complete, we must go back to previous guide and follow Enabling NexT instructions.