Self-host your Typography.js fonts with Gasby

January 05, 2020 • 3 min read
Edit on Github


I recently added a CSP to this blog, and one of the tricky parts when implementing this was that the fonts were coming from from Google fonts. Several extra directives were required, and depending on the browser I was using, it was not even working properly, I think Chrome wasn’t properly loading them, while Firefox was.


To fix this, I decided that I should self-host the fonts I need instead of linking to several Google domains. I was ready to download the file and copy them in my codebase, but then I realised there is no CSS/SASS, so nothing linking to them…

I’m using the Funston theme for Typography.js with the appropriate Gatsby plugin. The fonts are specified by the theme and the appropriate link tag are injected in the HTML when needed.

The only mention of self-hosting is in the Gatsby plugin options:

omitGoogleFont: (boolean, default: false) Typography includes a helper that makes a request to Google’s font CDN for the fonts you need. You might, however, want to inject the fonts into JS or use a CDN of your choosing. Setting this value to true will make gatsby-plugin-typography skip the inclusion of this helper. You will have to include the appropriate fonts yourself.

However, how to include them yourself is left unanswered, but luckily someone answered this question on Stackoverflow.


Ok, looks like I got all the pieces of the puzzle, let’s code!

First, let’s disable Google font from the gatsby-plugin-typography config:

// gatsby-config.js
  plugins: [
      resolve: `gatsby-plugin-typography`,
      options: {
        pathToConfigModule: `src/utils/typography`,
        omitGoogleFont: true,      },

The 2 fonts I need are “Patua One” and “Cabin Condensed”, and -following the previous Stackoverflow post- you can find on npm here and here:

yarn add typeface-patua-one typeface-cabin-condensed

Then add them to the onInitialClientRender browser API:

// gatsby-browser.js
exports.onInitialClientRender = () => {

And that’s pretty much it, now the fonts are self-hosted.

Cleaning up my CSP

As I said in the intro, the main driver for this change was my CSP, which was at best overly complicated, and at worst wrong. So now that it doesn’t need to be so complicated, let’s review it.

The usage of Google fonts require -at least- the following to work:

  • 'style-src':
  • 'font-src':
  • 'connect-src':
  • 'prefetch-src':

Some directives, like font-src and prefetch-src are only required for Google fonts, so I can remove them from the plugin config.

Final words

If you want to look at the entire change, I made a pull request for it, feel free to have a look to it.

Liked it? Please share it!

© 2024, Built with Gatsby