resir014/gatsby-starter-typescript-plus

A starter kit for TypeScript-based Gatsby projects with sensible defaults.

gatsby-starter-typescript-plus

A starter kit for TypeScript-based Gatsby projects with sensible defaults.

This is a starter kit for Gatsby.js websites written in TypeScript. It includes the bare essentials for you to get started (styling, Markdown parsing, minimal toolset).

🗒️ Features

• TypeScript
• ESLint (with custom ESLint rules)
• Markdown rendering with Remark
• Basic component structure
• Styling with emotion

🚀 Quick start

A nodejs >= 6.0.0 setup with yarn is recommended.

1. Create a Gatsby site.

   Install gatsby-cli package globally on your machine.

   # using NPM
   npm install -g gatsby-cli
   
   # using YARN
   yarn global add gatsby-cli

   Use the gatsby-cli to create a new site and install its dependencies.

   gatsby new project-name https://github.com/resir014/gatsby-starter-typescript-plus

2. Start developing.

   Move to project's directory.

   cd project-name/

   Start your site.

   # using npm
   npm start
   
   # using yarn
   yarn start

   Open source code using your favorite IDE/Text editor and navigate to src/ directory, this is where your application live.

3. Build your application for production.

   Once you're finished, you can make production build of your app using:

   # using npm
   npm run build
   
   # using yarn
   yarn build

4. Deploy your app to Github pages!

   After building your application in step 3, you're ready to publish your app and go online!

   # using npm
   npm run deploy
   
   # using yarn
   yarn deploy

❤️ Credits

Built with Gatsby - the blazing-fast static site generator for React.

💫 Deploy

gatsby-starter-typescript-plus's Issues

tslint -> eslint

tslint is going to be deprecated soon. Replace tslint + tslint-config-blvd with eslint + @typescript-eslint/parser + eslint-config-blvd as soon as possible.

Doesn't work with node > v10.0.0

Using node v10.2.1 and get the following error:

error [email protected]: The engine "node" is incompatible with this module. Expected version ">=8.0.0 <10.0.0".

using contentful plugin breaks the build of the project

using plugin "gatsby-source-contentful": "^2.1.6"
Gatsby CLI version: 2.7.7
Gatsby version: 2.10.0

I get this error if I add the contentful plugin to this starter and run gatsby develop

error gatsby-node.js returned an error

TypeError: Cannot destructure property slug of 'undefined' or 'null'.

• gatsby-node.js:65 allMarkdown.data.allMarkdownRemark.edges.forEach
  /Users/me/work/project/gatsby-node.js:65:35

• Array.forEach

• gatsby-node.js:64 Object.exports.createPages
  /Users/me/work/project/gatsby-node.js:64:44

I am adding the contentful plugin to gatsby-config.js like follows:

{
    resolve: `gatsby-source-contentful`,
    options: {
      spaceId: 'myId',
      // Learn about environment variables: https://gatsby.dev/env-vars
      accessToken: process.env.CONTENTFUL_ACCESS_TOKEN
    }
  },

What is causing this error ?