Skip to main content

Basic Setup

Theme installation

Starting from theme version v1.0.1 you'll need Ghost v5.54.1 or later

Upload the theme ZIP file

First, you must upload the theme ZIP file that you received and downloaded after purchase.
Follow the steps below to upload and activate the theme:

  1. Login to Ghost admin at yourpublication.com/ghost
  2. Go to the settings page by clicking on the settings icon in the bottom left corner
  3. Next, click on "Design"
  4. Then click on "Change theme" in the bottom left corner
  5. Next, click on "Upload theme" in the top right corner and select the theme ZIP file
  6. Once the upload is completed, click on "Activate"

Upload the routes.yaml file

Configuring the routes.yaml file is required for the theme to work properly, follow the steps below to set it up:

  1. Unzip the theme ZIP file and locate the routes.yaml file inside the theme folder
  2. Login to Ghost admin at yourpublication.com/ghost
  3. Go to the settings page by clicking on the settings icon in the bottom left corner
  4. Next, click on "Labs"
  5. Scroll to the "Routes" section and click on the "Upload routes YAML" button
  6. Select and upload the routes.yaml file that you find inside the theme root folder

This file defines the following routes and collections:

  • / — the homepage and main documentation
  • /blog — the Blog page
  • /changelog — the Changelog page
  • /showcase — the Showcase page

Read more under the advanced setup section if you need to configure a landing page or configure multiple documentation.

Uploading the routes.yaml file is a required step, without it the theme will not work properly.