Skip to content
Simple and minimalistic responsive theme for portfolios for the Grav CMS.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Portfolio Theme

Portfolio is a simple and minimalistic responsive theme for Grav CMS. It's designed for portfolios and personal webpages.

A demo can be found here.



bin/gpm install portfolio


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

You should now have all the theme files under


Manual Setup

If you don't use the Admin plugin and you want to set this theme 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: portfolio.
  • 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.

Once this is done, you should be able to see the new theme on the frontend.

How to create a portfolio page

Admin plugin

If you have the admin plugin you can simply create a page with the portfolio template and add child pages with the item template.

Manual usage

If you don't have the Admin plugin:

  1. Create a directory in user/pages, and create a file inside with the following structure:
title: Projects <!-- name your page -->
child_type: item
    items: '@self.children'
        by: default
        dir: asc
    limit: 6 <!-- number of items in page -->
    pagination: true
  1. For each item in yout portfolio create a directory inside the new directory that you previously created. Add an file with the following structure:
title: 'Portfolio Template'   <!-- title of your page -->
taxonomy:                     <!-- tags -->
        - Web 
banner_color: '#ff9100'       <!-- banner color used in the theme -->
links:                        <!-- links to resources related to your project -->
        title: Github
        url: ''
<!-- File contents in markdown format -->
  1. To add images simply copy an image file in the item's folder and it will be shown in the page. You may need to clear the cache folder for Grav to pick the image.

Finally, your folder structure should look like this:

File tree

You can’t perform that action at this time.