Skip to content
Image-heavy photography portfolio with colorful accents & great typography
TypeScript JavaScript
Branch: master
Clone or download

Gatsby Starter Portfolio: Jodie

A portfolio starter for Gatsby. The target audience are designers and photographers.

Demo Website

Deploy to Netlify Edit gatsby-starter-portfolio-jodie

Netlify Status CircleCI

  • CSS-Grid powered layout with Sidebar
  • Large images & Instagram integration
  • Themeable pages & automatically adapting sidebar


If you want to quickly bootstrap a design/photography portfolio or use it as a foundation for your personal site, the starters in gatsby-starter-portfolio are a perfect fit for you! The project's goal is to offer minimalistic and fast websites.

I hope you like my starters and create something awesome! To see some of my work, you can visit my website or support me on Patreon to get some neat rewards (4K images, project files, tutorial insights). Every pledge on Patreon helps me create more free starters!

Also, check out the other starters for gatsby-starter-portfolio:

Check out the Gatsby Starter Portfolio Overview!


  • Configurable
    • Use the config to easily change the most important information
    • Change the theming for styled-components
    • Navigation powered by a .yaml file
    • Layout driven by CSS-Grid
  • Create your projects by creating a folder full of images and adding an entry to a .yaml file
  • Shows your Instagram posts
  • TypeScript
  • Cypress for End-to-End testing
  • react-spring animations
  • Uses styled-components + styled-system for styling
  • Google Analytics support
  • SEO
    • Sitemap
    • JSONLD
    • OpenGraph Tags
    • Twitter Tags
  • Offline Support
  • WebApp Manifest Support
  • Responsive Images
    • Right image sizes
    • Blurred loading animation
    • WebP support

Getting Started

Check your development environment! You'll need Node.js, the Gatsby CLI and node-gyp installed. The official Gatsby website also lists two articles regarding this topic:

To copy and install this starter run this command (with "project-name" being the name of your folder you wish to install it in):

gatsby new project-name
cd project-name
npm run develop

Configuring the Instagram source plugin

  1. You need to have a Facebook page (I know... :/)
  2. Go to your site settings -> Instagram -> Login into your Instagram account
  3. Create a app
  4. Go to the Graph API Explorer
    1. Select your App from the top right dropdown menu
    2. Select "Get User Access Token" from dropdown (right of access token field) and select needed permissions (manage_pages, pages_show_list, instagram_basic)
    3. Copy user access token
  5. Access Token Debugger:
    1. Paste copied token and press "Debug"
    2. Press "Extend Access Token" and copy the generated long-lived user access token
  6. Graph API Explorer:
    1. Paste copied token into the "Access Token" field
    2. Make a GET request with "PAGE_ID?fields=access_token"
    3. Find the permanent page access token in the response (node "access_token")
  7. Access Token Debugger:
    1. Paste the permanent token and press "Debug"
    2. "Expires" should be "Never"
    3. Copy the access token
  8. Graph API Explorer:
    1. Make a GET request with "PAGE_ID?fields=instagram_business_account" to get your Business ID

Now create a .env file at the root of the project with the following content:


You can paste your access token and Business ID there.

Adding a new project

  1. Create a new folder in content/projects and place your images there
  2. Add your project to the content/projects/projects.yaml file

Adding a new page

Create a new .tsx file in the src/pages directory

Adding new features/plugins

You can add other features by having a look at the official plugins page

Building your site

npm run build

Copy the content of the public folder to your webhost or use a website like Netlify which automates that for you.


You can configure your setup in config/index.js:

module.exports = {
  pathPrefix: '/', // Prefix for all links. If you deploy your site to your pathPrefix should be "portfolio"

  siteTitle: 'Jodie', // Navigation and Site Title
  siteTitleAlt: 'Jodie - Gatsby Starter Portfolio', // Alternative Site title for SEO
  siteTitleShort: 'Jodie', // short_name for manifest
  siteHeadline: 'Come & Enjoy our excellent photos', // Headline for JSONLD
  siteUrl: '', // Domain of your site. No trailing slash!
  siteLanguage: 'en', // Language Tag on <html> element
  siteLogo: '/logos/logo.png', // Used for SEO and manifest
  siteDescription: 'Image-heavy photography portfolio with colorful accents & great typography',
  author: 'LekoArts', // Author for JSONLD

  // siteFBAppID: '123456789', // Facebook App ID - Optional
  userTwitter: '@jodie', // Twitter Username
  ogSiteName: 'jodie', // Facebook Site Name
  ogLanguage: 'en_US', // og:language
  googleAnalyticsID: 'UA-XXXXXX-X',

  // Manifest and Progress color
  themeColor: '#db7436',
  backgroundColor: '#3b3c4f',

You can also configure the styling of the site by editing the theme variables in config/theme.ts.

interface ThemeShape {
  breakpoints: string[]
  fontSizes: string[]
  colors: {
    [key: string]: string
  space: string[]
  fontWeights: {
    [key: string]: number
  sidebarWidth: {
    [key: string]: string

const theme: ThemeShape = {
  breakpoints: ['480px', '650px', '1000px', '1200px', '1400px'],
  fontSizes: ['1rem', '1.2rem', '1.44rem', '1.728rem', '2.074rem', '2.488rem'],
  colors: {
    primary: '#c66131',
    secondary: '#494992',
    grey: '#646066',
    shade: '#f5f5f5',
  space: [
  fontWeights: {
    normal: 400,
    bold: 700,
  sidebarWidth: {
    big: '375px',
    normal: '320px',

export default theme

Attention: You also need to edit static/robots.txt to include your domain!

You can’t perform that action at this time.