@ibas/gatsby-theme-agency v0.4.0

Check the Demo Site.

This step-by-step guide will walk you through adding gatsby-theme-agency to a new Gatsby project.

With the focus on the site features and content, you’ll get a Gatsby theme with three post types – blog, services and testimonial. This is ideal for a simple services consultancy or agency.

This theme also comes configured with the contact form if you are hosting your site on Netlify. All that is required from you is to turn it ON via the configuration file. You will get to that in a moment.

Let’s get started!

• Installation
• Updating the Project Structure
• Adding @ibas/gatsby-theme-agency in the gatsby-config.js
• Adding the Blog Posts
• Adding the services posts
• Adding Testimonial posts
• Run gatsby develop
• Configuring siteMetadata
• Adding Favicon to your Gatsby Site
• Component shadowing

Installation

Start by creating an empty directory in your preferred location (in my case Desktop) and go inside it

mkdir agency-site && cd agency-site

Next, run the following command to create a package.json file

yarn init –y

Then, run the following command to add all required dependencies

yarn add react react-dom gatsby @ibas/gatsby-theme-agency

Updating the Project Structure

Once the installation is complete, open with your text editor and update the project structure so it looks like this:

agency-site
    ├── contents
    │ ├── blog
    │ │   ├── 2020-10-08-my-first-blog-post
    │ │   │    ├── images
    │ │   │    │   └── featured.jpg
    │ │   │    │   └── content-image.jpg
    │ │   │    └── my-first-blog-post.md
    │ │   └── 2020-10-09-my-second-blog-post
    │ │        ├── images
    │ │        │   └── featured.jpg
    │ │        │   └── content-image.jpg
    │ │        └── my-second-blog-post.md
    │ ├── services
    │ │   ├── images
    │ │   │    └── react.png
    │ │   │    └── html5.png
    │ │   │    └── gatsby.png
    │ │   │    └── google-analytics.png
    │ │   └── design.md
    │ │   └── development.md
    │ │   └── digital-marketing.md
    │ └── testimonial
    │     ├── images
    │     │    └── client1-avartar.png
    │     │    └── client2-avartar.png
    │     │    └── client3-avartar.png
    │     └── client1.md
    │     └── client2.md
    │     └── client3.md
    ├── images
    │   └── client1-logo.png
    │   └── client2-logo.png
    │   └── client3-logo.png
    │   └── client4-logo.png
    ├── node_modules
    ├── src
    │   └── static
    │       └── fav-icon.png
    ├── gatsby-config.js
    └── package.json

Adding @ibas/gatsby-theme-agency in the gatsby-config.js

At this point, you should have the gatsby-config.js in the root directory as directed above. If you don’t have it yet, create it.

Then, load the plugin:

module.exports = {
  plugins: [
    {
      resolve: `@ibas/gatsby-theme-agency`,
    },
  ],
}

Good. Now, you can start creating your site content.

Adding the Blog Posts

Remember, in step 2, we created the entire project structure. For the blog posts, you’ll have something like this:

agency-site
    └── contents
      └── blog
          └── 2020-10-08-my-first-blog-post
              ├── images
              │   └── featured.jpg
              │   └── content-image.jpg
              └── my-first-blog-post.md

Modify the post path in the contents/blog to reflect yours. In my case, the .md file lives in the 2020-10-08-my-first-blog-post directory.

In the file, add your first blog post so it looks like this:

---
title: "Deploying Gatsby Site"
description: "Lorem ipsum dolor sit amet consectetur, adipisicing elit."
category: "Development"
datePublished: "2020-08-16 10:31:00"
dateUpdated: "2020-08-16 10:31:00"
featured: "./images/gatsby-deploy.jpg"
tags:
  - gatsby
  - development
---

Lorem ipsum dolor sit amet consectetur, adipisicing elit. Veritatis, perferendis eum.

1. Deserunt ipsam a cumque, in nesciunt facilis obcaecati natus!

![body image](./images/gatsby-deploy.jpg)

In the same directory, you should have an images folder where you add the necessary images.

Adding the services posts

In the contents/services directory, create your services files. In my case, I have design.md, development.md and digital-marketing.md. I also have images folder that contains all the necessary images.

The structure should look like this:

agency-site
    └── contents
      └── services
              └── images
              │    └── react.png
              │    └── html5.png
              │    └── gatsby.png
              │    └── google-analytics.png
              └── design.md
              └── development.md
              └── digital-marketing.md

Just like the blog post, your markdown files should contain some frontmatter as seen below.

---
title: "Web Design Services"
description: "Lorem ipsum dolor sit amet consectetur adipisicing elit."
date: "2020-08-27 10:31:00"
cover: ./images/web-design.jpg
tools:
  [
    { title: "HTML5", image: ./images/html5.png },
    { title: "CSS3", image: ./images/css3.png },
  ]
faq:
  [
    {
      id: 1,
      question: "Lorem ipsum dolor sit amet?",
      answer: "Lorem ipsum dolor sit amet consectetur adipisicing elit.",
    },
    {
      id: 2,
      question: "Lorem ipsum dolor sit amet?",
      answer: "Lorem ipsum dolor sit amet consectetur adipisicing elit.",
    },
    {
      id: 3,
      question: "Lorem ipsum dolor sit amet?",
      answer: "Lorem ipsum dolor sit amet consectetur adipisicing elit.",
    },
  ]
---

Mollitia numquam laudantium illum qui impedit vero iste necessitatibus eaque.

- suscipit facilis tenetur sunt sint modi esse culpa quasi
- recusandae mollitia nihil ullam fugiat minima laboriosam sed voluptatibus.

Make sure you maintain the same structure.

Adding Testimonial posts

This is straight forward. In the contents/testimonial directory, create your files so you have something like this:

agency-site
    └── contents
      └── testimonial
          ├── images
          │    └── client1-avartar.png
          │    └── client2-avartar.png
          │    └── client3-avartar.png
          └── client1.md
          └── client2.md
          └── client3.md

Then, open your .md file and add your testimonial post:

---
name: "Andrew John"
title: "Chief Marketing Officer, ABC Group"
photo: "./images/ibas_avartar.png"
date: "2020-08-28 10:31:00"
---

Lorem ipsum dolor sit amet consectetur, adipisicing elit. Dignissimos, molestias?

Don’t forget to add the client picture/avatar in the contents/testimonial/images folder.

Run gatsby develop

Save your files. While in the root of your project, run gatsby develop to start the development server. Once you have a success, head over to the browser address bar and visit localhost:8000 to see your site.

In addition to the contents you’ve added, you’ll also see some of the default data in your project. Let’s go ahead and make changes to the default.

Configuring siteMetadata

Back in the gatsby-config.js, update the file to include the options parameter as seen below. While it is advisable to maintain some of the default options like the content path (since we have created the project structure already in step 2), you'll want to change the default site content.

Note: You’ll need to restart the site once you make any changes in this file.

module.exports = {
  plugins: [
    {
      resolve: `@ibas/gatsby-theme-agency`,
      options: {
        blogBasePath: ``, // indicate "/blog" if you want posts URL as "/blog/my-post" or leave empty if you want "/my-post"
        blogPostPath: `contents/blog`,
        testimonialPath: `contents/testimonial`,
        servicesPostPath: `contents/services`,
        title: `Business`, // will be the site title
        description: `I showcase my expertise in this website`,
        siteUrl: `https://ibaslogic.com`,
        siteName: `Ibaslogic`,
        giHubPostBaseURL: `https://github.com/Ibaslogic/gatsby-site-agency/tree/master/contents/blog/`,
        menuLinks: [
          { name: `blog`, title: `Blog`, url: `` },
          {
            name: `services`,
            title: `Services`,
            url: ``,
          },
          {
            name: `contact`,
            title: `Contact Us`,
            url: ``,
          },
          { name: `about`, title: `About Us`, url: `` },
          {
            name: `testimonials`,
            title: `Testimonials`,
            url: ``,
          },
        ],
        // Color for menu links
        linkMenuColor: { color: "#2d2d2d", hover: "#b2924e" },
        // needed for blog post share
        twitter: `ibaslogic`,
        // for follow
        social: [
          // icons supported for "instagram" and "googlePlus". Just add the exact name and link here.
          { name: `linkedIn`, link: `https://www.linkedin.com/in/ibaslogic` },
          { name: `twitter`, link: `https://twitter.com/ibaslogic` },
          { name: `github`, link: `https://github.com/ibaslogic` },
          { name: `facebook`, link: `https://facebook.com/ibaslogic` },
        ],
        email: `ibas@ibaslogic.com`,
        companyAddress: `XYZ, Sanusi Fafunwa, Victorial Island, Lagos.`,
        mobileNumber: `+234 813 9542 386`,
        author: `Ibas Majid`,
        homePage: {
          hero_content: {
            headingText: `Web Development Services`,
            descriptionText: `For clients who want to ditch the stress of complicated websites and have a modern and user friendly site.`,
            buttonText: `contact us`,
            typeWriter: [
              `Want to take your business and brand to the next level?`,
              `Then, you need a user friendly website`,
              `<strong><span style="color: #27ae60;">That is why we are here </span></strong>😎`,
              `We listen and create an astonish project for our clients`,
              `The question is: Are you ready to talk about your project?`,
              `Then, go ahead and get in touch`,
            ],
            homeHero: `home_hero.jpg`, //Important. Specify image file for the home page hero image (e.g home_hero_bg.jpg) and add it in the agency-site/images folder
          },
          ourClients: {
            heading: `Our Clients are awesome! Are you ready to join this amazing list?`,
            subHeading: `Lorem ipsum dolor sit amet consectetur adipisicing elit. Aspernatur eaque reprehenderit suscipit facilis tenetur sunt sint modi esse culpa quasi. Lorem ipsum dolor sit amet consectetur adipisicing elit.`,
            images: [
              // add clients images in the images folder.
              { image: `verizon.png` },
              { image: `bosch.png` },
              { image: `samsung.png` },
              { image: `yamaha_.png` },
              { image: `carlson__.png` },
              { image: `williams.png` },
            ],
          },
          services: {
            arrowText: `learn more`,
            headingText: `featured services`,
            buttonText: `explore`,
            buttonTextLinkTo: `/services`,
          },
          // testimonial section homepage
          testimonial: {
            headingText: `words from our clients`,
            linkText: `read more`,
            buttonText: `all testimonial`,
            buttonTextLinkTo: `/testimonials`,
          },
        },
        footerSection: {
          consultation: {
            heading: `Need a consultation?`,
            subHeading: `Then let's talk! We are here to provide you the best service.`,
            buttonText: `contact us`,
            buttonTextLinkTo: `/contact-us`,
          },
        },
        servicesPage: {
          // single page
          hero_content: {
            buttonText: `start a project`,
          },
          // listing page
          listingPage: {
            heading: `At your service`,
            subHeading: `Lorem ipsum dolor sit amet consectetur adipisicing elit spernatur eaque reprehenderit suscipit. Aspernatur eaque reprehenderit suscipit`,
          },
        },
        // testimonial page
        testimonialPage: {
          heading: `Testimonials`,
          subHeading: `Lorem ipsum dolor sit amet consectetur adipisicing elit spernatur eaque reprehenderit suscipit. Aspernatur eaque reprehenderit suscipit`,
        },
        // contact page
        contactPage: {
          heading: `Let's talk about your project`,
          subHeading: `Lorem ipsum dolor sit amet consectetur adipisicing elit spernatur eaque reprehenderit suscipit`,
          showContactForm: true, // Not hosting on netlify? set to false. Else, set to true and start receiving submissions in your Netlify site admin panel.
        },
      },
    },
  ],
}

Restart the gatsby develop.

You should be able to see your site content rendered. Else, create an issue.

Adding Favicon to your Gatsby Site

Stop your dev server and run this command from your root directory:

yarn add gatsby-plugin-manifest

Then add this to your gatsby-config.js:

{
  resolve: `gatsby-plugin-manifest`,
  options: {
    name: `gatsbytheme`,
    short_name: `gatsbytheme`,
    start_url: `/`,
    background_color: `#663399`,
    theme_color: `#663399`,
    display: `minimal-ui`,
    icon: `src/static/gatsby-icon.png`, // This path is relative to the root of the site.
  },
},

Depending on where you want to save your icon. You can modify the icon path to point to that directory. With the current path as seen above, simply create a src folder in the project root. Inside this folder, create a static folder and place your icon.

Save your file and start the development server.

Component Shadowing

You may want to make changes that are not captured in the gatsby configuration file. For instance, the content of the /about-me is not present in the file. So what can we do?

While we can fork the theme and make necessary changes, Gatsby provides us with a more intuitive way to handle this scenario.

With component shadowing, we can use a naming convention or strategy to tell Gatsby not to render a file that comes with the theme but the one we create in the site project.

It is important to quickly note that this is not restricted to only React component as the name suggest, but any other files like markdown, CSS or JavaScript (.js, JSON etc).

So how does this work?

Say we want to override the content of the /about-me page. First, you have to know where the file is located in the theme.

As you may have known, a Gatsby theme is just like a normal plugin that lives in the node_modules folder. So, to know the file path, go inside the node_modules folder in the root directory and look for the theme. In our case, we will look for @ibas\gatsby-theme-agency.

From this folder, navigate inside the src. There, you’ll find the theme styles, component files and some other files like the .json file.

If you scrutinize the folder, the about-me content is located in the src/contents/aboutMe.json. Open it to see its content and structure.

To override this content, you'll start by creating a src folder in the root of your project. Inside it, create another folder in the name of the theme and follow the same path as you have it in the node_modules.

In the end, you’ll have:

src/@ibas/gatsby-theme-agency/contents/aboutMe.json

Once you create this file, you can have your content modified. Then, Gatsby will render this file and not the one with the same name in the theme’s src/contents/ directory.

Your site folder structure for a successful shadow of the aboutMe.json should look like this:

agency-site
  └── src
       └── @ibas\gatsby-theme-agency
           └── contents
                └── aboutMe.json

Using the same approach, you can shadow any other files including the theme styles.