Adding Typescript Part 2 (Gatsby)

gatsby logo typescript logo

Gatsby Config & Node API

After converting all my react components on the site to Typescript I looked around for references to people using Gatsby with Typescript based config.

Finding a Workaround

The most insightful thing I found was a gist.

Github Gist - JohnAlbin - TypeScript + Gatsby config and node API

Gatsby looks for gatsby-config.js (javascript) so simply renaming the file will not work.

Instead you need to use ts-node to load typescript & export all variables from gatsby-config.ts.
As ts-node is active Gatsby should then load other gatsby components using the .ts extension.

ts-node is a TypeScript execution engine and REPL for Node.js.

It JIT transforms TypeScript into JavaScript, enabling you to directly execute TypeScript on Node.js without precompiling.
This is accomplished by hooking node's module loading APIs, enabling it to be used seamlessly alongside other Node.js tools and libraries.

TypeStrong/ts-node on Github

Implementing ts-node in gatsby-config

  • install ts-node as a dependency
  • rename gatsby-config.js to gatsby-config.ts
  • create new gatsby-config.js with ts-node
  • export everything from gatsby-config.ts
  • rename gatsby-*.js to gatsby-*.ts



module.exports = require('./gatsby-config.ts')

Gatsby should now reference typescript based config files. (eg: gatsby-node.ts, gatsby-browser.ts)

You may need to refactor some existing code depending on how you have Typescript configured.

Typescript Config


    "compilerOptions": {
        "module": "CommonJS",
        "target": "ESNext",
        "lib": [
        "strict": true,
        "moduleResolution": "node",
        "sourceMap": true,
        "jsx": "preserve",
        "allowJs": true,
        "noEmit": true,
        "skipLibCheck": true,
        "esModuleInterop": true,
        "noImplicitAny": false,
        "forceConsistentCasingInFileNames": true,
        "allowSyntheticDefaultImports": true,
    "exclude": [
You may want to start with strict: false then work towards enabling strict mode later.

Source Code

You can find the full pull request for the above changes of this site on github.

Using Typescript For Gatsby Config & Node API

The source for the site is available on github.