Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Casper2 πŸ‘»

Grav theme

Casper2 Theme


As you can see, this theme uses images in the header of every post.
If you don't have an image set and ready, you can select a placeholder image from unsplash that will show as background.
To do this, use the default card background image under theme options.

You can find examples on how to set desired unsplash image or set of images that will change upon reloading on unsplash


Basic usage instructions:

  • Change the logo in Themes Β» Casper 2.

  • Change social icons by writing your id after the site name in the theme configuration.

  • Change the favicon tagline text there too.

  • Create a page of type : blog and go to Advanced in the admin.

  • Under body-classes write home-template

  • While you're there, in blog page

    • Go to content tab
    • Upload your own primary Image
    • Hit save

The blog page should be blank, without any text.

Under blog page you can now create as many posts with page template item as you want.
This is how you populate your blog.

In this theme you can also create a page of type : archive. Pages with type archive will list all your posts written so far.


This Grav theme is port of a Casper theme for ghost, which is released under MIT licence.

GPM Installation (Preferred)

The simplest way to install this theme is via the Grav Package Manager (GPM) through your system's Terminal (also called the command line). From the root of your Grav install type:

bin/gpm install casper

This will install the Gateway theme into your /user/themes directory within Grav. Its files can be found under /your/site/grav/user/themes/casper.

Manual Installation

To install this theme, just download the zip version of this repository and unzip it under /your/site/grav/user/themes. Then, rename the folder to casper.

You should now have all the theme files under


If you want to set Casper2 as the default theme, you can do so by following these steps:

  • Navigate to /your/site/grav/user/config.
  • Open the system.yaml file.
  • Change the theme: setting to theme: casper.
  • Save your changes.
  • Clear the Grav cache. The simplest way to do this is by going to the root Grav directory in Terminal and typing bin/grav clear-cache.

GPM Update (Preferred)

The simplest way to update this theme is via the Grav Package Manager (GPM). You can do this with this by navigating to the root directory of your Grav install using your system's Terminal (also called command line) and typing the following:

bin/gpm update casper

This command will check your Grav install to see if your Gateway theme is due for an update. If a newer release is found, you will be asked whether or not you wish to update. To continue, type y and hit enter. The theme will automatically update and clear Grav's cache.

Manual Update

Manually updating theme is pretty simple. Here is what you will need to do to get this done:

  • Delete the your/site/user/themes/casper2 directory.
  • Download the new version of theme from this repository.
  • Unzip the zip file in your/site/user/themes and rename the resulting folder to casper2.
  • Clear the Grav cache. The simplest way to do this is by going to the root Grav directory in terminal and typing bin/grav clear-cache.

Thank You

Grav has fantastic team, people that are very helpful and people that I probably bored to death, or at least quite a lot to achieve what I want. In Slack's chat room I bugged always helpful @andrewscofield @ricardo, and @olevik.

Words cannot express how thankful I am to all of you. I'm the one to blame if anything is wrong, πŸ˜… but you guys helped to get most of the things right. So kudos to you.

And at last, but not least - Thank You if you're using this theme. πŸ™‚