⛔ DEPRECATED

This repository is no longer maintained and only works for Strapi v3. You can find the latest Strapi v4 version of this starter on the starters-and-templates monorepo.


Strapi Starter Gatsby Corporate Site

This starter is designed for flexibility. Using it, you'll be able to manage your website content entirely in Strapi, and get a Gatsby app automatically generated. Marketing teams will be able to create pages and design their layout without help from developers.

This starter features:

  • Pages creation within Strapi, no code necessary
  • Fully flexible page structure: design the pages you want using UI Sections
  • 8 UI Sections out of the box: Hero, RichText, LargeVideo, Testimonials, Pricing, BottomActions, FeatureRows, FeatureColumns
  • Easy to theme with Tailwind
  • Static site generation with Gatsby
  • An integrated Preview Mode, to view your pages on a private URL before publishing them
  • Content in multiple languages using i18n

This starter uses the Strapi corporate template

Check out all of our starters here

Getting started

Use our create-strapi-starter CLI to create your project.

npx create-strapi-starter@3 my-site gatsby-corporate

The CLI will create a monorepo, install dependencies, and run your project automatically.

Preview Mode

Start by setting a GATSBY_PREVIEW_SECRET value in your environment variables. You can create an environment file by copying our sample one:

cp .env.development.example .env.development

You can then turn preview mode on with a URL like this:

http://localhost:8000/en/preview/<slug>?secret=<gatsby-preview-secret>

<slug> is the slug you entered in Strapi for your page. <gatsby-preview-secret> is the secret token defined in your .env.development / .env.production config,

Once preview mode is on you can then access draft pages with urls like this:

http://localhost:8000/preview/<slug>

A banner will remain under the navigation to let you know preview mode is and it will allow you turn it off.

Customize your corporate site

To edit this website, you'll need to run both the frontend and the backend in your development environment.

Adding Sections

We have built sections for you, but you will likely want to add more to fit your needs. Follow these steps:

  • Create a new component in Strapi in the "sections" category
  • In the Content-Types Builder, open the Pages collection and check your new section on the contentSections field.
  • Create a React component that takes a data prop in /frontend/components/sections
  • To link your Strapi section to this React component, open /frontend/components/sections.js, and add an entry to the sectionComponents object.

Custom theme

We use Tailwind CSS for styling. To modify your page's look, you can edit the theme in /front/tailwind.config.js. Read the Tailwind docs to view all the changes you can make. For example, you can change the primary color like this:

const { colors } = require(`tailwindcss/defaultTheme`);

module.exports = {
  theme: {
    extend: {
      colors: {
        primary: colors.green,
      },
    },
  },
};

Deploying to production

You will need to deploy the frontend and backend projects separately. Here are the docs to deploy each one:

Don't forget to set up your environment variables on your production apps.

Here are the required ones for the frontend:

  • GATSBY_STRAPI_URL: URL of your Strapi backend, without trailing slash
  • GATSBY_PREVIEW_SECRET: a random string used to protect your preview pages

Have fun using this starter!