Skip to main content

Basic Setup

Getting Started

This theme requires Ghost v6.39.0 or later

Theme Installation

Upload the theme ZIP file

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

  1. Log in to Ghost admin
  2. Click on Settings in the left sidebar
  3. Next, look for the Theme settings and click on it
  4. Then click on Change theme
  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. Log in to Ghost Admin
  3. Click on Settings in the left sidebar
  4. Next, look for the Labs settings and click on it
  5. Click Open and under the Routes section, click on Upload routes file
  6. Select and upload the routes.yaml file located in the theme root folder

This file automatically defines the following routes and collections:

  • / — Homepage and main documentation
  • /blog/ — Blog page
  • /changelog/ — Changelog page
  • /showcase/ — Showcase page
  • /roadmap/ — Roadmap page
  • /tags/ — Tags archive
Uploading the routes.yaml file is a required step, without it the theme will not work properly.
After uploading the routes.yaml file for the first time, you will see a 404 error on the homepage.
This is expected and will be resolved once you configure the docs page.

Design considerations

Ghost provides design setup under Settings > Design & branding.
There are two main sections under these settings:

  • Brand: those are the default design settings provided by Ghost
  • Theme: design settings provided by the theme

Keep the following points in mind to ensure your site works seamlessly on both dark and light modes:

Logos

Light theme logo: the logo uploaded in Brand > Publication logo will be used for the website’s light theme. It will also be used in the Ghost Portal and emails, since both use a light theme.

Dark theme logo: the logo uploaded in Theme > Dark theme logo will be used only for the website’s dark theme.

If your logo is clearly visible on both dark and light themes, you can skip setting the Dark theme logo.

Accent color

Light theme color: the color set in Brand > Accent color will be used for the website’s light theme. It will also be used in the Ghost Portal and emails, since both use a light theme.

Dark theme color: the color set in Theme > Dark theme accent color will be used only for the website’s dark theme.

If your accent color is accessible on both dark and light themes, you can skip setting the Dark theme accent color.

Typography

We recommend not changing the default typography settings under the Brand section. Instead, use the ones under the Theme section: Body font & Headings font.

Updated on May 20, 2026