Theme Installation

Start by unzipping the downloaded package by double-clicking it on Mac or by right-clicking and selecting “Extract All” in Windows.

Inside the new folder minim, you will find the minim.zip theme file.

Follow these steps to upload the theme to your website:

  • Log in to your Ghost website admin (https://yourdomain.com/ghost).
  • Click on the settings icon at the bottom of the left-hand side.
  • Navigate to Design → Change theme.
  • Click Upload theme and select the minim.zip theme file.

Once uploaded. Click on Activate now button to activate the theme immediately or Close if you want to activate it later.

Routes Setup

The routes.yaml file is required for member sign up, and subscription flows.

To upload the routes file, follow these steps:

  • Unzip the minim.zip theme file.
  • In your Ghost admin, click the settings icon at the bottom of the left-hand side.
  • Navigate to Labs.
  • Scroll down to the Routes section and click the Upload routes YAML button.
  • Select and upload the routes.yaml file inside the theme folder.

Note: upload routes.yaml after uploading the theme zip

There will be a default routes.yaml file uploaded to Ghost and you'll need to upload your theme's routes.yaml to override the default.

Upload the routes.yaml file separately after uploading your theme zip file.

Site Title, Description & Cover

To set the site Title, Description and Cover photo shown on the homepage, refer to the following settings in your Ghost admin that corresponds to the diagram below:

  1. Site Title and Description - General > Title & description
  2. Site Logo - General > Publication logo
  3. Site Cover Photo - General > Publication cover

Note: The cover photo uploaded here will be displayed as the background of your site’s signin and signup pages (if members are enabled).

Homepage Setup

Minim uses a custom homepage template that automatically displays your portfolio and testimonial posts.

To setup your homepage, simply navigate to your Ghost admin panel and create a new page with the title of Home. Any content in your Home page will appear above the portfolio

Important: The title of the page used for your homepage must be Home.

To copy the style of the Minim demo homepage, give your text the style of a large heading:

Blog Setup

A blog page at /blog is created automatically by Ghost after you upload the routes.yaml file.

All posts that are not tagged with #portfolio or #testimonial will appear on your /blog page.

Portfolio Setup

Minim features custom portfolio post styles you can use to display your work. Portfolio items are displayed on the homepage. You can edit the style of portfolio using the portfolio styles theme option.

You can add items to your portfolio by creating a Post and tagging it with the internal tag of #portfolio.

You can may add additional tags to the post, but it must contain the #portfolio tag in order to appear in your portfolio.

Portfolio items will be displayed using the custom portfolio template.

Portfolio Admin View

Once you’ve created a portfolio post, you can add a custom view in your Ghost admin panel to quickly access your portfolio posts. To do so, navigate to your Ghost admin panel > Posts, sort by the tag of #portfolio and click the Save as new view… button.

Testimonials Setup

Minim features custom testimonial post styles you can use to display your testimonials or reviews. Testimonials are displayed on the homepage. You can edit the style of testimonials using the testimonial styles theme option.

You can add testimonials by creating a Post and tagging it with the internal tag of #testimomial.

A post must contain the #testimonial tag in order to appear as a testimonial.

Testimonial Admin View

Once you’ve created a testimonial post, you can add a custom view in your Ghost admin panel to quickly access your testimonial posts. To do so, navigate to your Ghost admin panel > Posts, sort by the tag of #testimonial and click the Save as new view… button.

Theme Options

Minim has custom configuration options that will help you customize your site. To access these options, navigate to your Ghost admin panel > Settings > Design.

Color Scheme

The color scheme of Mimim can be changed to one of three options.

  • Light
  • Dark
  • Auto

Modern operating systems (Windows, macOS, iOS, etc.) allow users to choose their preference for light or dark system themes. The Auto feature is used to detect if the user has requested the system to use a light or dark color theme.

Dark Mode Switch

To allow users to select dark mode for your site and additionally add an icon your navigation to allow them to toggle dark mode, enable this option.

Override the default copyright text that appears in the footer of your site.

Disable the link in the footer that references “Published with Ghost.”

Portfolio Styles

Choose the portfolio style used to display your portfolio items. View a demo of the different styles below:

Testimonial Size

Set the size of the testimonial slider displayed on the homepage underneath the portfolio.

Portfolio Filter

Option to hide or show the portfolio filter feature.

Disqus Comments

Disqus is a commenting platform that lets you communicate directly with your readers. DocuHub integrates with Disqus so you can collect users’ feedback on your articles.

Paste your Disqus shortname, e.g. copy only your-site from your-site.disqus.com

Note: Minim supports native Ghost comments. To learn how to enable them, read this.

Theme Customization

Minim can be customized to fit your company’s brand easily. The main font and all colors used throughout the theme can be easily changed. Follow the steps below:

Custom CSS

Minim is styled using CSS variables that allow you to customize nearly every style of the theme without editing any theme files.

To get started customizing, Copy & paste the code below into your Ghost Admin > Code Injection > Site Header and override any values you’d like for a completely customized look and feel.

<style>
:root {
  /* Fonts */
  --font-family-primary: 'Encode Sans', sans-serif;
  --font-family-secondary: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif;

  /* Globals */
  --max-width-global-wrap: 1100px;
  --max-width-compact-wrap: 850px;
  --border-radius: 3px;
  --height-logo-header: 40px;
  --font-size-logo-header: 40px;
  --height-logo-footer: 40px;
  --font-size-logo-footer: 40px;
  --grid-gap-portfolio-fullwidth: 1px;
  --grid-gap-portfolio-fixedwidth: 15px;
  --grid-gap-authors: 35px;
  --grid-gap-tags: 35px;

  /* Colors */
  --color-font-default: #2b2b2b;
  --color-font-secondary: #777777;
  --color-link-underline: #dfdfdf;
  --color-body: #fff;
  --color-highlight: #efeef0;
  --color-dropdown-bg: #ffffff;
  --color-dropdown-shadow: rgba(39,44,49,0.12) 0 2px 26px, rgba(39, 44, 49, 0.10) 1px 3px 8px;
  --color-code-bg: #f1f4f4;
  --color-input-bg: #f5f5f5;
  --color-input-bg-hover: #ebebeb;
  --color-border: #eaeaea;
  --color-tag: #ecedee;
  --color-tag-hover: #e5e6e8;
}
</style>

You can add, edit, delete and reorder main menu links on your Ghost blog from the navigation in the admin area located under Settings > Design.

Minim also supports a Secondary Navigation in the form of social media icons displayed in your site’s footer:

Simply type the name of the social media site as the link name and Minim will automatically use the associated icon for the site. For a list of the supported social media sites, check the following link:

👉 Supported Social Media Sites

Custom Pages

Memberships Page

A custom membership page template with pricing table is included with this theme. To enable it, navigate to Pages > New page from the navigation menu on the left of your admin area.

  • Click the settings icon when editing a page
  • Scroll down and at the bottom to the Template dropdown
  • Click on the dropdown and select Memberships

Authors Page

A custom authors page template is included with this theme. To enable it, navigate to Pages > New page from the navigation menu on the left of your admin area.

  • Click the settings icon when editing a page
  • Scroll down and at the bottom to the Template dropdown
  • Click on the dropdown and select Authors

Tags Page

A custom tags page template is included with this theme. To enable it, navigate to Pages > New page from the navigation menu on the left of your admin area.

  • Click the settings icon when editing a page
  • Scroll down and at the bottom to the Template dropdown
  • Click on the dropdown and select Tags

Compact Page

A custom compact page template that provides a slimmer layout for your pages.

  • Click the settings icon when editing a post or page
  • Scroll down and at the bottom to the Template dropdown
  • Click on the dropdown and select Page Compact

Contact Page

  1. Navigate to the URL below to create a free Formspree account and setup a new form:
    https://formspree.io/create/t2themes
  2. Copy the endpoint URL found on your forms “Integrations” page.
  3. Create a new page and name it Contact for example.
  4. Once you are in the page editor, click on the circle (+) icon and then choose the HTML block.
  5. Add the contact form code using FORMSPREE as a service. Please check the code example below:

    <form action="[FORMSPREE ENDPOINT]" method="POST">
      <input type="text" name="name" placeholder="Name">
      <input type="email" name="_replyto" placeholder="Email">
      <textarea name="message" placeholder="Message"></textarea>
      <input type="submit" value="Send">
    </form>
    
  6. Replace the [FORMSPREE ENDPOINT] with the URL you copied during step
  7. Publish the page.
  8. To add the page to the navigation, please check the Navigation section above.
  9. Check your email to confirm your email address with Formspree.
  10. Once you confirmed your email address, the form will be ready and you will get an email once when anyone uses your form.
  11. You can then style your form based on your design and add more fields or customize the form based on your requirements, so be sure to visit Formspree website for more information.

Translations

Minim supports Ghost i18n and comes with English language by default.

To add a new language, follow the steps in the Official Ghost Documentation.

Theme Development

If you are a developer and are looking to do heavy customization work. The theme uses Gulp to compile Sass and JavaScript.

This improves the development flow and making it much faster and efficient.

First, make sure you have Node.jsnpm, and Gulp CLI installed. Run the following command in the theme root directory to install npm dependencies.

npm install

To start Gulp, run:

gulp

This will compile Sass and JavaScript files, and start watching changes as you edit files.

Do customizations in the assets/css files for CSS or in assets/js for JavaScript.

Finally, when you are finished your customizations, run the following command to generate the them zip file for uploading to your Ghost blog.

gulp zipper

Your zip file will be located in the dist/ folder.

Theme Updates

You can update your theme the same way as you initially installed it. Simply:

  • Download the latest version of the theme from your Gumroad or ThemeForest account (depending on where you originally purchased the theme).
  • Upload the theme zip file in your Ghost admin panel under Settings > Theme > Upload a theme

One thing to reduce the need for redoing customization is to use the Code Injection feature in your Ghost admin. This is very helpful for adding custom CSS and analytics tracking code for example.

Ghost Hosting

When you're ready to take your website live we have the hosting recommendation that’s right for you.

Browse Ghost Hosting Options →

Sources and Credits

The primary font used is:

Demo images used are:

Icon set used is: